# Swagger UI
[](http://badge.fury.io/js/swagger-ui)
**ðð¼ Want to score an easy open-source contribution?** Check out our [Good first issue](https://github.com/swagger-api/swagger-ui/issues?q=is%3Aissue+is%3Aopen+label%3A%22Good+first+issue%22) label.
**ð°ï¸ Looking for the older version of Swagger UI?** Refer to the [*2.x* branch](https://github.com/swagger-api/swagger-ui/tree/2.x).
This repository publishes to two different NPM modules:
* [swagger-ui](https://www.npmjs.com/package/swagger-ui) is a traditional npm module intended for use in single-page applications that are capable of resolving dependencies (via Webpack, Browserify, etc).
* [swagger-ui-dist](https://www.npmjs.com/package/swagger-ui-dist) is a dependency-free module that includes everything you need to serve Swagger-UI in a server-side project, or a single-page application that can't resolve npm module dependencies.
We strongly suggest that you use `swagger-ui` instead of `swagger-ui-dist` if you're building a single-page application, since `swagger-ui-dist` is significantly larger.
## Compatibility
The OpenAPI Specification has undergone 5 revisions since initial creation in 2010. Compatibility between Swagger UI and the OpenAPI Specification is as follows:
Swagger UI Version | Release Date | OpenAPI Spec compatibility | Notes
------------------ | ------------ | -------------------------- | -----
3.18.3 | 2018-08-03 | 2.0, 3.0 | [tag v3.18.3](https://github.com/swagger-api/swagger-ui/tree/v3.18.3)
3.0.21 | 2017-07-26 | 2.0 | [tag v3.0.21](https://github.com/swagger-api/swagger-ui/tree/v3.0.21)
2.2.10 | 2017-01-04 | 1.1, 1.2, 2.0 | [tag v2.2.10](https://github.com/swagger-api/swagger-ui/tree/v2.2.10)
2.1.5 | 2016-07-20 | 1.1, 1.2, 2.0 | [tag v2.1.5](https://github.com/swagger-api/swagger-ui/tree/v2.1.5)
2.0.24 | 2014-09-12 | 1.1, 1.2 | [tag v2.0.24](https://github.com/swagger-api/swagger-ui/tree/v2.0.24)
1.0.13 | 2013-03-08 | 1.1, 1.2 | [tag v1.0.13](https://github.com/swagger-api/swagger-ui/tree/v1.0.13)
1.0.1 | 2011-10-11 | 1.0, 1.1 | [tag v1.0.1](https://github.com/swagger-api/swagger-ui/tree/v1.0.1)
## Documentation
#### Usage
- [Installation](docs/usage/installation.md)
- [Configuration](docs/usage/configuration.md)
- [CORS](docs/usage/cors.md)
- [OAuth2](docs/usage/oauth2.md)
- [Deep Linking](docs/usage/deep-linking.md)
- [Limitations](docs/usage/limitations.md)
- [Version detection](docs/usage/version-detection.md)
#### Customization
- [Overview](docs/customization/overview.md)
- [Plugin API](docs/customization/plugin-api.md)
- [Custom layout](docs/customization/custom-layout.md)
#### Development
- [Setting up](docs/development/setting-up.md)
- [Scripts](docs/development/scripts.md)
##### Integration Tests
You will need JDK of version 7 or higher as instructed here
http://nightwatchjs.org/gettingstarted#selenium-server-setup
Integration tests can be run locally with `npm run e2e` - be sure you aren't running a dev server when testing!
### Browser support
Swagger UI works in the latest versions of Chrome, Safari, Firefox, Edge and IE11.
### Known Issues
To help with the migration, here are the currently known issues with 3.X. This list will update regularly, and will not include features that were not implemented in previous versions.
- Only part of the parameters previously supported are available.
- The JSON Form Editor is not implemented.
- Support for `collectionFormat` is partial.
- l10n (translations) is not implemented.
- Relative path support for external files is not implemented.
## Security contact
Please disclose any security-related issues or vulnerabilities by emailing [security@swagger.io](mailto:security@swagger.io), instead of using the public issue tracker.
## License
Copyright 2018 SmartBear Software
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at [apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
swagger接口管理框架 （369个子文件） 
.agignore 6B .babelrc 978B nginx.conf 2KB swagger-ui.css 150KB Dockerfile 699B .dockerignore 70B .editorconfig 171B .eslintrc 716B .eslintrc 178B .eslintrc 127B .eslintrc 95B .gitattributes 26B .gitignore 205B
index.html 4KB oauth2-redirect.html 2KB oauth2-redirect.html 2KB index.html 2KB index.html 2KB index.html 1KB swagger-ui-bundle.js 916KB swagger-ui.js 736KB swagger-ui-standalone-preset.js 299KB utils.js 32KB fn.js 31KB system.js 25KB utils.js 22KB main.js 19KB allow-empty-value.openapi.js 18KB allow-empty-value.swagger.js 18KB selectors.js 18KB actions.js 13KB system.js 13KB selectors.js 13KB pet.js 10KB state-integration.js 10KB json-schema-components.js 8KB fn.js 7KB example.js 7KB json-schema-form.js 7KB actions.js 6KB curlify.js 6KB base.js 6KB actions.js 6KB deep-linking.js 6KB index.js 5KB wrapComponent.js 5KB store.js 5KB reducers.js 5KB layout.js 5KB reducer.js 5KB user.js 4KB markdown.js 4KB preauthorize.js 4KB model-example.js 4KB parameter-oneof.js 4KB make-webpack-config.js 4KB actions.js 4KB root-injects.js 4KB download-url.js 3KB schemes-wrapper.js 3KB selectors.js 3KB wrap-auth-selectors.js 3KB info.js 3KB selectors.js 3KB operations.js 3KB reducers.js 3KB pet.js 3KB oauth2-authorize.js 3KB models.js 3KB live-response.js 3KB online-validator-badge.js 2KB selectors.js 2KB informationContainer.js 2KB markdown.js 2KB helpers.js 2KB parameter-enum-rendering.js 2KB servers-wrapper.js 2KB version-pragma-filter.js 2KB object-model.js 2KB 4557-default-parameter-values.js 2KB 4196.js 2KB parameter-oneof.js 2KB wrap-selectors.js 2KB frozen-array-input.js 2KB schemes.js 2KB response.js 2KB wrap-selectors.js 2KB filter.js 2KB info-wrapper.js 2KB reducers.js 2KB schemeContainer.js 2KB callbacks.js 2KB index.js 2KB primitive-model.js 2KB 4756.js 1KB webpack-hot-dev-server.config.js 1KB markdown-script-sanitization.js 1KB webpack-dist.config.js 1KB models.js 1KB link.js 1KB共 369 条
- 1
- 2
- 3
- 4
资源评论
