# Swagger UI
[![NPM version](https://badge.fury.io/js/swagger-ui.svg)](http://badge.fury.io/js/swagger-ui)
## New!
**This is the new version of swagger-ui, 3.x. Want to learn more? Check out our [FAQ](http://swagger.io/new-ui-faq/).**
**ðð¼ 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.
As a brand new version, written from the ground up, there are some known issues and unimplemented features. Check out the [Known Issues](#known-issues) section for more details.
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 JavaScript web application projects 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 web project that can't resolve npm module dependencies.
For the older version of swagger-ui, refer to the [*2.x branch*](https://github.com/swagger-api/swagger-ui/tree/2.x).
## 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.12.1 | 2018-03-09 | 2.0, 3.0 | [tag v3.12.1](https://github.com/swagger-api/swagger-ui/tree/v3.12.1)
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 2017 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-ui-master
共285个文件
js:129个
jsx:69个
md:24个
需积分: 9 9 下载量 131 浏览量
2018-12-28
11:15:23
上传
评论
收藏 4.86MB ZIP 举报
温馨提示
java项目通过swagger统一生成api,自动生成接口说明ui,使用简单方便,
资源推荐
资源详情
资源评论
收起资源包目录
swagger-ui-master (285个子文件)
.agignore 6B
.babelrc 820B
nginx.conf 2KB
swagger-ui.css 150KB
Dockerfile 670B
.dockerignore 70B
.editorconfig 171B
.eslintrc 769B
.eslintrc 154B
.gitattributes 26B
.gitignore 152B
index.html 4KB
index.html 3KB
oauth2-redirect.html 2KB
oauth2-redirect.html 2KB
swagger-ui-bundle.js 1.48MB
swagger-ui-standalone-preset.js 431KB
swagger-ui.js 353KB
utils.js 28KB
fn.js 28KB
system.js 24KB
main.js 24KB
utils.js 21KB
system.js 13KB
selectors.js 12KB
actions.js 12KB
pet.js 10KB
state-integration.js 10KB
selectors.js 8KB
ast.js 8KB
fn.js 7KB
json-schema-components.js 6KB
curlify.js 6KB
actions.js 5KB
wrapComponent.js 5KB
store.js 5KB
base.js 5KB
index.js 5KB
actions.js 5KB
json-schema-form.js 4KB
reducers.js 4KB
user.js 4KB
markdown.js 4KB
parameter-oneof.js 4KB
model-example.js 4KB
root-injects.js 4KB
download-url.js 3KB
make-webpack-config.js 3KB
selectors.js 3KB
wrap-auth-selectors.js 3KB
reducer.js 3KB
selectors.js 3KB
operations.js 3KB
reducers.js 3KB
pet.js 3KB
oauth2-authorize.js 3KB
live-response.js 3KB
models.js 3KB
selectors.js 2KB
informationContainer.js 2KB
object-model.js 2KB
spec-wrap-actions.js 2KB
parameter-oneof.js 2KB
wrap-selectors.js 2KB
schemes.js 2KB
response.js 2KB
wrap-selectors.js 2KB
reducers.js 2KB
schemeContainer.js 2KB
primitive-model.js 2KB
callbacks.js 2KB
webpack-hot-dev-server.config.js 1KB
markdown-script-sanitization.js 1KB
webpack-dist.config.js 1KB
index.js 1KB
not-of-type.js 1KB
models.js 1KB
topbar.js 1KB
actions.js 1KB
oauth2-authorize.js 1KB
reducers.js 1KB
actions.js 1KB
info-sanitization.js 1KB
hook.js 1024B
curlify.js 1016B
selectors.js 1008B
operation.js 963B
reducers.js 958B
layout-wrap-actions.js 918B
index.js 875B
wrap-spec-actions.js 867B
3279-empty-markdown-source.js 863B
not-of-type.js 858B
refs.js 842B
webpack-dist-standalone.config.js 838B
helpers.js 831B
index.js 813B
webpack-dist-bundle.config.js 811B
markdown.js 809B
actions.js 801B
共 285 条
- 1
- 2
- 3
资源评论
dairan0918
- 粉丝: 3
- 资源: 8
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功