众多界面管理工具如雨后春笋般涌现。令人欣慰的是,有很多来自中国的优秀作品,包括YApi和rap。看着中文官网,熟悉的中文不禁让人耳目一新。当然,这也带来了另一个缺点,因为使用基数小,参考资料少。想要学习如何使用,只能依赖官方文档,可谓是福也是祸。本文将带你走进Yapi的世界,让你体验一个小巧清爽的界面管理工具。YApi有什么用据统计,目前市面上互联网项目超过10亿个,保守统计涉及的API数量为100亿个。但很多API的质量堪忧。因为与API相关的文档、调试、测试和数据模拟在工作中非常低??效。我们急需一款产品,需要具备界面管理功能,提供调试、文件管理和测试功能。这时,YApi诞生了。这是一个接口管理平台,帮助开发者创建、发布和维护API。YApi还为用户提供了极佳的交互体验。开发者只需要使用平台提供的接口数据写入工具和简单的点击操作即可实现接口管理。图片来自YApi官网。YApi的安装不是一点点。您需要先下载mongoDB数据库,然后才能部署它。由于文章篇幅有限,具体的安装过程就不展示了。YApi的现状如何?YApi适用于公司复杂的业务,尤其是跨部门协作的情况。与之类似的工具包括说唱、swagger和moco。Rap也有图形化界面,但是没有yapi那么流行。至于swagger,它是一个超级强大的工具。其志向不再满足于接口管理,后续课程再谈。Moco在2013年获得了DukeChoiceAward,moco的使用也非常简单。它维护一个json文件,然后用命令运行它。面对如此多的工具,YApi想要脱颖而出实属不易。在实际工作中,YApi和swagger属于两个流派。前者易于管理,UI界面友好,但生态薄弱,依赖人工和UI维护。至于swagger,则是不折不扣的野心家,已经提供了API全生命周期的解决方案。它不再是一种工具,而是成为一种标准。3进入YApi进入YApi之后,这个页面,这个UI真是小清新,不愧是后起之秀。这里简单介绍一下,主要有以下四个部分:首页头部显示当前位置、搜索框、新建项目、查看文档和用户信息。群组信息显示在首页左侧。“组”是“项目”的集合。只有超级管理员可以管理群组。首页右侧是群组下的项目和成员列表。点击左侧的一个群组,右侧会出现该群组下的项目和成员信息。点击项目右上角的星号即可关注项目,您关注的项目可在“我的关注”页面查看。其实不只是首页UI,他的项目的UI也是让人咋舌。UI上如此清新的国产平台实属难得。一目了然的项目布局点击一个项目进入项目页面,页面显示属于该项目的所有接口。并提供项目的所有操作和接口。项目页面左侧的“接口列表”显示项目下的所有接口,右侧默认显示项目下所有接口的列表。点击左侧的界面,右侧会出现“预览”、“编辑”、“运行”。点击左侧“测试集”,即可使用测试集功能。点击二级导航中的“设置”,项目负责人可以编辑项目信息和管理成员列表。点击二级导航中的“动态”,可以查看该项目的运行日志。如何启动界面有些读者已经迫不及待了!下面用一个简单的例子来入门YApi,在项目中新建一个接口,会弹出一个窗口,几个选项都很清楚,接口路径是什么?这样方便前端调用后端,设置界面路径:点击新添加的界面,右侧可以看到界面的预览信息,点击右侧的编辑,进入编辑面板。在这个面板中,可以看到接口的基本信息(接口名称、类别、路径)。此外,还可以完善以下接口信息:接口路径:可以更改HTTP请求方式,支持restful动态路由,比如/api/{id}/{name},id和name为动态参数status:used判断接口是否已经开发。Tag:用于标识接口标签信息(v1.3.23+)。在接口列表页面,您可以根据标签过滤接口。我们往下看,你会看到请求参数。您可以设置请求需要哪些参数。他们可能是必需的。也可以不要:查询参数:接口url的查询字符串。点击“添加查询参数”按钮添加参数,可以拖动交换参数位置Headers:http请求头字段。当req_body表单为form格式时,header中会自动生成'Content-Typeapplication/x-www-form-urlencoded',其他3种格式也会自动生成不同的header请求参数后接返回数据,即分为json&raw两种形式。这是一种基于mockjs和json5,使用注解来编写参数描述的方式。不明白的请关注下方链接。这是官网对Mock的介绍。Mock介绍:https://hellosean1025.github....以上只是接口的设置,但是我们经常会遇到一些情况,比如我想根据不同的请求返回不同的HTTPCode,HTTPheader和JSON数据参数和IP,这么复杂的情况,接口设置是不可能的,期待Mock登场!它说:“靠边站,我能行!”ExpectMock期望Mock根据设置的请求过滤规则返回期望的数据,属于高端玩家。使用它首先要进入接口详情页面,然后点击AdvancedMock。点击AddExpectation,填写过滤规则和期望返回数据,如下图,最后点击OK。我们在浏览器中测试一下,发送一个符合规则的请求:最后,正如文章所说,YApi在这么多工具面前脱颖而出实属不易。在实际工作中,YApi和swagger属于两个流派。前者易于管理,UI界面友好,但生态薄弱,依赖人工和UI维护。至于swagger,则是不折不扣的野心家,已经提供了API全生命周期的解决方案。它不再是一种工具,而是成为一种标准。
