> 官网:[swagger](http://swagger.io/) ## Swagger 一个开源的接口框架，提供了多种工具，帮助你解决与`api`的不同的情况下的问题，包含的子项目如下： ## 核心工具 | 名称 | github地址 | 作用 | | --- | --- | --- | | [Swagger Core](http://swagger.io/swagger-core/) | [https://github.com/swagger-api/swagger-core](https://github.com/swagger-api/swagger-core) | Java依赖库，用于生成或阅读`Swagger definitions`，可以理解为Swagger的一个中间产物 | | [Swagger Codegen](http://swagger.io/swagger-codegen/) | [https://github.com/swagger-api/swagger-codegen/tree/develop_2.0](https://github.com/swagger-api/swagger-codegen/tree/develop_2.0) | 通过`Swagger definitions`在命令行下生成Client/Server端的代码 | | [Swagger UI](http://swagger.io/swagger-ui/) | [https://github.com/swagger-api/swagger-ui](https://github.com/swagger-api/swagger-ui) | 一个简单的浏览swagger接口文档的文件服务器 | | [Swagger Editor](http://swagger.io/swagger-editor/) | [https://github.com/swagger-api/swagger-editor](https://github.com/swagger-api/swagger-editor) | 一个浏览工具，不过支持在线编辑、执行，且能查看响应结果的这么一个工具，支持YAML/Json格式的接口文件下载 | ## 其他工具 | 名称 | github地址 | 作用 | | --- | --- | --- | | Swagger JS | [https://github.com/swagger-api/swagger-js](https://github.com/swagger-api/swagger-js) | js客户端，方便使用`js`语言调试 | | Swagger Node | [https://github.com/swagger-api/swagger-node](https://github.com/swagger-api/swagger-node) | JS依赖库 | | Swagger-Socket | [https://github.com/swagger-api/swagger-socket](https://github.com/swagger-api/swagger-socket) | 通过`websocket`方式调用`swagger`形式的`api` | | Swagger Parser | [https://github.com/swagger-api/swagger-parser](https://github.com/swagger-api/swagger-parser) | 工具类，Java语言，独立使用解析`Swagger definitions` | ## 总结 Swagger是个庞大的体系，需要慢慢细啃，这一周就它了。