接口管理工具YApi怎么用？颜值高、易管理、超好用

众多接口管理工具如雨后春笋搬冒出。让人欣慰的是，有许多优秀做品来自国内，包含YApi和rap。

看着中文的官网，熟悉的汉语，不由让人暗爽。固然这也就带来另外一个弊端，由于使用基数少，因此参考资料少。咱们想学习使用方法，只能依赖官方文档，也算是福祸相倚了。

本文将带您走进Yapi的世界，让您体验一回小清新的接口管理工具。

YApi有什么用

根据统计，市面上互联网项目超过10亿，保守统计涉及的API数量有100亿。可是不少API的质量堪忧。由于与API相关的文档、调试、测试和数据Mock在工做中效率很是低。

咱们急需一款产品，它须要具备接口管理功能，提供调试，文档管理和测试功能。这时YApi横空出世。

这是一个接口管理平台，能够帮助开发者建立、发布和维护API。YApi 还为用户提供了优秀的交互体验。开发人员只需利用平台提供的接口数据写入工具以及简单的点击操做就能够实现接口的管理。

图片来自YApi官网

YApi的安装并非点点点，你须要下载mongoDB数据库，而后才能够部署。因为文章篇幅有限，就不展现具体安装过程了。

YApi的地位如何

YApi适合公司业务比较复杂，尤为是跨部门协做的状况下使用，和它相似的工具还有rap、swagger、moco。

rap也具备图形界面，但火爆程度逐渐不如yapi。而swagger呢，是一个超级强大的工具，它的野心已经不知足于接口管理，后续课程会讲到它。

moco在13年获取Duke选择奖，moco的使用也很简单，维护一份json文件，而后利用命令运行。

在这么多工具面前，YApi可以脱颖而出实属不易。在实际工做中，YApi和swagger属于两个流派，前者易于管理，有着友好的UI界面，但生态弱，依赖人工和UI维护。而swagger呢，是一个十足的野心家，已经提供api全生命周期的解决方案，它已经不是工具，已然成为了标准。

3进入YApi

进入YApi后，这页面，这UI，确实小清新，不愧是后起之秀。这里简单进行介绍，它主要有下面四个部分：

首页头部展现了当前所在的位置、搜索框、新建项目、查看文档和用户信息。

首页左侧展现分组信息，“分组”是“项目”的集合，只有超级管理员能够管理分组。

首页右侧是分组下的项目和成员列表，点击左侧的某个分组，右侧会出现该分组下的项目和成员信息。

点击项目右上角的星星便可关注项目，关注的项目能够在“个人关注”页面查看。

其实不光是首页UI，他的项目UI也使人咋舌，在UI上这么清新的国内平台已经很是少见。

清晰项目布局

点击一个项目，进入项目页，项目页展现了属于该项目的所有接口。并提供项目、接口的所有操做。

项目页左侧的 “接口列表” 展现了该项目下的全部接口，右侧默认显示该项目下全部接口的列表。

点击左侧的某个接口，右侧会出现“预览”、“编辑”和“运行”。

点击左侧的 “测试集合” 使用测试集功能。

点击二级导航的“设置”，项目组长便可编辑项目信息和管理成员列表。

点击二级导航的“动态”，便可查看项目的操做日志。

如何开始接口

有的读者已经火烧眉毛了！下面用一个简单例子来入门YApi，在项目里新建接口，这时会弹出一个窗口，几个选项都很清楚，接口路径是什么？这是方便前端调用后端，而设置的接口路径：

点击新添加的接口，右侧能够看到接口的预览信息，点击右侧的编辑进入编辑面板。在该面板中你能够看到接口的基本信息(接口名称、分类、路径)，除此之外，你还能够完善如下接口信息：

接口路径：能够更改 HTTP 请求方式，而且支持 restful 动态路由，例如 /api/{id}/{name}, id和name是动态参数

状态：用于标识接口是否开发完成。

Tag：用于标识接口tag信息（v1.3.23+）,在接口list页能够根据tag过滤接口

咱们接着往下看，你会看到请求参数，能够设置请求时须要哪些参数，它们能够是必需，也能够是没必要须：

Query参数：接口 url 的查询字符串。点击『添加Query参数』按钮来添加参数，能够经过拖动来交换参数位置

Headers：http 请求头字段。在 req_body 形式是 form 格式下会在 header 中自动生成 'Content-Type application/x-www-form-urlencoded'，其余3种格式也会自动生成不一样 header

请求参数后面是返回数据，它分为 json & raw 两种形式。基于 mockjs 和 json5，这是一种使用注释的方式写参数说明，若是你看不懂，请注意下面的连接，这是官网对Mock的介绍。

Mock介绍：

https://hellosean1025.github....

上面只是对接口的设置，但咱们常常遇到一些状况，好比我想根据不一样的请求参数、IP返回不一样的 HTTP Code、HTTP 头和 JSON 数据，这么复杂的状况，接口设置是没法作到的，指望Mock登场！它说：“大家靠边站，我能够作到！”

指望Mock

指望Mock能够根据设置的请求过滤规则，返回指望数据，这是一个高端玩家。要想使用它，你要先进入接口详情页，而后点击高级Mock。

点击添加指望，填写过滤规则以及指望返回数据，以下图这样，最后点击肯定。

咱们在浏览器里测试一下，发送符合规则的请求:

写在最后

就像文中说的那样，在这么多工具面前，YApi可以脱颖而出实属不易。在实际工做中，YApi和swagger属于两个流派。前者易于管理，有着友好的UI界面，但生态弱，依赖人工和UI维护。而swagger呢，是一个十足的野心家，已经提供api全生命周期的解决方案，它已经不是工具，已然成为了标准。