虽然Swagger的界面不干净，功能不充分会经常被吐槽，但是实际上有很多可以和Swagger组合使用的工具，组合起来会变得非常好用。 以前写过一篇文章叫《Swagger界面丑、功能弱怎么破？用Postman增强下就给力了！》，有朋友留言说YApi也很好用。 我最近体验了YApi，发现确实不错。 推荐！
YApi简介
YApi是一个高效、易用、功能强大的API管理平台，旨在为开发、产品和测试人员提供优雅的界面管理服务。 YApi在Github上累计了18K Star，拥有出色的交互体验。 YApi不仅提供常用的接口管理功能，还提供权限管理、Mock数据、Swagger数据导入等功能，总之功能很强！
安装
环境准备
要在本地部署YApi，必须首先安装nodejs和MongoDB。 首先安装。安装nodejs，直接下载安装软件包，双击安装即可。 此处安装的是12.14.0版。 下载地址为https://nodejs.org/dist/v 12.14.0/node-v 12.14.0-x64.MSI； 要安装MongoDB，请参阅安装《MongoDB快速入门，掌握这些刚刚好！》。 这里安装了4.2.5版。
安装yapi-cli
YApi-cli是YApi官方提供的安装工具，可以通过视觉界面部署YApi服务，非常方便。
使用npm命令安装yapi-CLI。 在成功安装了NPM install-gy API-CLI--注册表3359注册表. NPM.Taobao.org之后，控制台将输出以下内容：
安装成功后，请使用yapi服务器命令启动yapi的可视部署接口。 yapi服务器
通过
安装YApi
可视化部署接口安装YApi服务，访问地址： http://localhost :9090
安装完成后，将输出以下消息，指示YApi的默认管理员帐户密码和访问位置
进入YApi的安装目录，使用node命令启动YApi服务。 成功启动node vendors/server/app.js后，控制台的输出信息如下。
从页面访问Yapi。 默认帐户密码为admin@admin.com:ymfe.org，访问地址为http://localhost 33603000
使用
从Swagger导入数据
使用管理员帐户成功登录后，创建mall-tiny-group组；
分组成功后，单击该组下的项目创建，添加mall-tiny-swagger项目；
然后启动以前的mall-tiny-Swagger项目，启动成功后，输入swagger界面文档访问地址： http://localhost 33608088/swagger-ui /
toutiaoimg.com/origin/pgc-image/5641951887e643979060ae332f3ed1da?from=pc">选择好YApi的数据管理功能，配置好Swagger的api-docs路径，然后进行数据导入；
至此Swagger中的API接口已成功导入到YApi，点击接口标签查看所有导入接口。
接口管理
打开添加商品的接口看看，可以看到非常完善的接口文档信息，注释都有了；来试试接口运行功能，我们会发现默认的接口请求地址并不符合我们的要求，需要在环境配置中设置；
由于是跨域请求，Chrome浏览器需要安装跨域请求插件，下载地址：https://github.com/YMFE/cross-request/archive/master.zip
由于我们的部分接口在请求头中添加token才能访问，所以我们先调用登录接口获取token；
之后在设置->环境配置中添加Authorization头；
再次调用需要登录的接口，可以正常获取到数据，返回数据虽然格式化了，但是没有折叠功能，数据太长的话就不太好看了；
Mock功能
在我们调用POST接口提交JSON数据时，默认Mock的JSON数据有点不太符合我们的要求；可以通过接口信息中的编辑->高级设置进行修改；
我们可以发现每一个接口信息中都有个Mock地址，当我们后台接口已经定义好格式，但是没有实现时，前端可以使用该地址来Mock数据进行调试；
调用Mock地址可以获取到一些测试数据，数据取值返回可以通过上面的Mock设置自行修改；
从Swagger自动同步
当我们的接口修改了，API文档如何同步呢，我们可以通过设置->Swagger自动同步来开启自动同步功能，有三种数据同步模式可以选择；权限管理
如果有新的成员加入进来，需要查看API文档怎么办？
首先可以通过注册界面注册一个成员账号，此处账号为test@qq.com:123456；之后使用管理员账号登录，然后通过成员列表->添加成员，将用户添加到相应分组；
最后使用成员账号登录即可访问相应API文档了。
总结
YApi结合Swagger使用果然很强大！之前使用Postman结合Swagger使用时，文档查看、自动同步的问题都得到了解决，为了保证我们API文档访问的安全性还提供了权限管理功能。当API数据格式定义好后，Mock功能让前端无需后台实现也可以调试接口。不过对于JSON格式支持有点偏弱，要是能对JSON数据进行折叠显示就更好了！
参考资料
官方文档：https://hellosean1025.github.io/yapi/documents/index.html
项目源码地址
https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-swagger