> 官網:[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是個龐大的體系,需要慢慢細啃,這一周就它了。