作为一位后端开发,咱们平时常常须要保护API文档、对API接口进行调试、有时候还得Mock数据。Postman尽管作为接口调试工具十分好用,然而对于保护API文档这类工作却不太适合。明天给大家举荐一款性能更弱小的工具Apifox,足以满足咱们对API的各种需要,心愿对大家有所帮忙!

SpringBoot实战电商我的项目mall(50k+star)地址:https://github.com/macrozheng/mall

Apifox简介

Apifox 的定位是Postman + Swagger + Mock + JMeter,具备API文档治理、API调试、API Mock、API 自动化测试等性能。能够通过一种工具解决之前应用多种工具的数据同步问题。高效、及时、精确!

装置

  • Apifox的装置十分不便,间接下载安装包解压装置即可,下载地址:https://www.apifox.cn/

  • 官网十分贴心地提供了示例我的项目,间接关上即可体验Apifox的性能,看下界面还是很漂亮的;

  • 咱们本人应用的话首先须要新建团队,便于团队成员之间协同工作;

  • 而后在团队中新建我的项目,新建胜利后咱们就能够开始应用Apifox的弱小性能了!

API文档导入

Apifox的API文档导入性能十分弱小,反对包含Swagger、Postman、YApi、ShowDoc等多达20种工具的导入。接下来咱们通过应用之前mall-tiny-swagger我的项目中的接口,来体验下它的导入性能!
  • 首先咱们抉择新建接口按钮,抉择导入

  • 而后关上导入界面,抉择Swagger->URL导入,输出Swagger的数据URL;

  • 导入时将显示导入预览,显示要导入的接口数据模型,Apifox将会把咱们接口返回的实体类转换为数据模型,以便进行复用;

  • 导入胜利后界面成果如下,Apifox将查看文档和批改文档做了辨别,不便咱们治理接口文档。

接口治理

尽管从Swagger中导入的接口文档曾经很具体了,然而为了体验Apifox更为弱小的性能,咱们有时候还是须要编辑下接口信息的。

接口设计

  • 看下Apifox的申请参数界面,十分具体!

  • 再看下Apifox返回后果界面,反对折叠,这个很多工具都是没有的;

  • 再看下Apifox的批改文档界面,反对增加状态、分组和标签。

接口调试

咱们再来体验下Apifox的调试性能,比Postman更弱小!
  • 在咱们开发接口时,很多时候须要分不同的环境,Apifox默认给咱们分了测试环境正式环境Mock服务,这三个根本也够用了;

  • 在调试接口之前,咱们得先设置好环境所对应的前置URL,比方这里咱们设置了测试环境的;

  • 在Apifox中咱们能够应用接口用例来调试咱们的接口,接口用例能够保留咱们输出的参数,以便之后测试应用;

  • Apifox反对在接口调用前后做自定义操作,比方咱们能够在后置操作中增加一个断言,返回后果中code等于200示意操作胜利;

  • 此时咱们输错明码来调用下接口,断言会间接提醒咱们后果和预期不合乎;

  • 有些接口咱们须要传入Authorization头能力拜访;

  • 这种拜访咱们能够通过环境变量来实现,首先在登录接口中增加后置操作,抉择提取变量,将返回的token提取到环境变量AUTH_TOKEN中;

  • 而后批改接口文档,在Header中设置须要传入Authorization头;

  • 接下来在接口用例中通过表达式应用Authorization头即可失常拜访须要登录认证的接口了。

应用脚本

Apifox的自定义前置操作后置操作十分弱小,不仅反对简略的断言提取变量,还能反对编写JS脚本。
  • 例如之前咱们判断操作胜利,断言code等于200能够应用脚本这样实现;

  • 此时咱们输错明码来调用下接口,断言会间接提醒咱们后果和预期不合乎。

Mock数据

在咱们后端接口没有开发实现,前端开发须要数据时,往往能够通过Mock来提供数据,Apifox的Mock数据性能也是很弱小的。
  • Apifox号称能依据你数据模型中的字段名称智能Mock,让咱们来看看它的规定;

  • 其实默认的Mock规定有时候并不是很欠缺,比方咱们来看下它Mock的数据;

  • 此时咱们能够在数据模型中批改,能够让Mock的数据更加人性化一点,比方咱们能够将各种状态设置为枚举类型;

  • 还能够将logo字段通过@image这种形式设置为图片类型;

  • 从新设置一下之后,人性化多了;

  • 接下来只需把环境改为Mock服务就能够调用Mock数据的接口了!

测试治理

Apifox不仅能反对接口调试,还反对创立测试用例进行批量测试以及性能测试。
  • 首先咱们能够在测试治理中创立测试用例;

  • 之后抉择从接口用例导入,抉择好须要导入的接口用例;

  • 抉择好运行环境后,点击运行进行批量测试;

  • 测试实现后即可显示测试报告;

  • 如果你想进行性能测试的话,在测试界面抉择好线程数即可;

  • 测试实现后,能够通过导出报告来查看更为具体的报告信息。

主题设置

集体比拟习惯暗色主题,Apifox也是能够抉择亮色主题和主色的,间接在设置中能够进行切换。

总结

Apifox的确是一款界面丑陋、功能强大的API接口工具。Postman有的接口调试性能它根本都有,还集成了接口文档治理、数据Mock、自动化测试等性能,强烈建议大家尝试下!

参考资料

官网文档:https://www.apifox.cn/help/

我的项目源码地址

https://github.com/macrozheng...

本文 GitHub https://github.com/macrozheng/mall-learning 曾经收录,欢送大家Star!