介绍
Swagger API框架，用于管理项目中API接口，属当前最流行的API接口管理工具。 Swagger功能强大，UI界面漂亮，支持在线测试等！
Swagger包括库、编辑器、代码生成器等很多部分，Swagger UI是一个API在线文档查看和测试的利器，Swagger Editor主要是编写api接口文档，但需要配合Swagger UI来展示，使用yaml编写。
国内开发者也有提供一整套开源的解决方案sosoapi，基于swagger的实现的，操作简单方便。可以导出swagger文件或者PostMan文件等。sosoapi是基于json文档的形式整合swagger，提供在线表单编辑对应的json格式文档及相关的一些团队协助功能，如团队成员管理，权限控制，导出html/word，编辑日志，复制项目/接口，mock服务。表单形式的编辑方式大大降低了集成swagger的学习成本，使得团队能快速上手。界面的展示也是使用原生的Swagger UI。
1. Swagger
Swagger Editor
Github项目 下载项目并解压并放入http容器/web容器（如tomcat等）访问目录名既可。（不知道为什么官网下载的一直不可以使用，后面到csdn下载一个就可以使用。百度网盘地址：http://pan.baidu.com/s/1geRhBSv 【swagger-editor.zip】）
Swagger UI
Github主页 下载源码，将dist目录访放入http容器/web容器（如tomcat等）即可通过目录名“dist”访问。
2. SosoApi
本地：只需要到 sosoapi Github项目地址 下载项目，并将dist目录下war包即可部署到tomcat既可使用和在线一样的功能。
Eclipse部署源码
到 sosoapi Github项目地址 下载项目（web和framwork），并将项目部署到Eclipse，修改部分pom，并将framwork里面的项目都分别导入到Eclipse，项目结构如图：
即可部署sosoapi-web到web容器如tomcat等，调通的Eclipse项目下载：链接：http://pan.baidu.com/s/1o7Zbpqy 密码：iapf，其他具体项目配置参考项目目录下的doc的文档。
1. Swagger
通过Swagger Editor编写基于YAML语法定义的RESTful API，然后它会自动生成一篇排版优美的API文档，并且提供实时预览。并且可以生产客户端和服务器的接口定义的代码。
编辑完，下载json文件“swagger.json”
将json文件导入Swagger UI中，在Swagger UI项目根目录下修改index.html文件
访问Swagger UI主页即可看到更新的api
Swagger 集成代码的用法
Swagger 可以和Spring MVC或Spring Boot 整合，通过注解自动生成Swagger 文档。
资料
1. 官网 http://swagger.io/
2. 相关文档 http://swagger.io/docs/
3. http://www.cnblogs.com/whitewolf/p/4686154.html 【Swagger - 前后端分离后的契约-破狼】
4. http://www.sosoapi.com/ 【swagger-ui 国内在线的扩展版】
5. http://bbs.sosoapi.com/forum.php?mod=viewthread&tid=220#lastpost 【SosoApi和Swagger有什么关联？】
6. http://www.2cto.com/kf/201604/499072.html 【Swagger使用】
