超详细的Apifox接口测试全解(完整版)
Apifox 是 API 文档、API 调试、API Mock、API 自动化测试一体化协作平台。功能定位 Postman + Swagger + Mock + JMeter。Apifox主要用于接口管理、开发、测试全流程集成工具,使用受众为整个研发技术团队,主要使用者为前端开发、后端开发和测试人员。而且公网SaaS版本完全免费。
一. Apifox简介
Apifox 是 API 文档、API 调试、API Mock、API 自动化测试一体化协作平台。
功能定位 Postman + Swagger + Mock + JMeter。
Apifox主要用于接口管理、开发、测试全流程集成工具,使用受众为整个研发技术团队,主要使用者为前端开发、后端开发和测试人员。而且公网SaaS版本完全免费。
二. 背景需求
1、概述
目前市面上很多团队都有前端后端测试三个岗位,当一个团队在开始开发一个项目前,前端与后端需要提前约定好接口,一般会安排一名开发工程师去编写一个API文档,通常会使用Swagger,此时后端会根据API文档去编写接口,而调试的时候则需要通过先前的文档再到Postman里面重新定义。
与此同时,在后端把接口做出来之前,前端如果想要提前开始开发的话,他又需要提前去Mock数据,他又要重新在Mock.js里写一遍接口定义。
测试则需要按照文档去Jmeter中去编写测试用例。而且在开发过程中也常会出现接口变更,此时还要同时改变Swagger、Postman、Mock、Jmeter里的定义,或者前后端联调的时候也常常会出现前后端数据类型不同的情况,而测试在最终对接口测试的时候也可能会出现实际返回值与文档不一致。整个开发团队的协同因此非常低效。
既然整个开发团队都是围绕API进行开发,但是现在的开发工作被分散在不同的开发工具上,Apifox的开发人员为解决上述痛点,因此便推出了Apifox
Apifox支持团队开发,开发团队可以同时工作,当API定义人员在Apifox上定义接口后,会实时同步给所有的团队成员。
同时Apifox还提供了更丰富的基于API的开发包
2、解决的问题
一套系统、一份数据,解决多个系统之间的数据同步问题。
只要定义好接口文档,接口调试、数据 Mock、接口测试即可直接使用,无需再次定义。
接口文档和接口开发调试使用同一个工具,接口调试完成后即可保证和接口文档定义完全一致。
高效、及时、准确!
3、最佳实践
前端(或后端):在 Apifox 上定好接口文档初稿。
前后端:一起评审、完善接口文档,定好接口用例。
前端:使用系统根据接口文档自动生成的 Mock 数据进入开发,无需手写 mock 规则。
后端:使用接口用例 调试开发中接口,只要所有接口用例调试通过,接口就开发完成了。如开发过中接口有变化,调试的时候就自动更新了文档,零成本的保障了接口维护的及时性。
后端:每次调试完一个功能就保存为一个接口用例。
测试人员:直接使用接口用例测试接口。
所有接口开发完成后,测试人员(也可以是后端)使用集合测试功能进行多接口集成测试,完整测试整个接口调用流程。
前后端都开发完,前端从Mock 数据切换到正式数据,联调通常都会非常顺利,因为前后端双方都完全遵守了接口定义的规范。
4、功能介绍
(1)接口设计:Apifox 接口文档遵循OpenApi3.0 (原 Swagger)、JSON Schema规范的同时,提供了非常好用的可视化文档管理功能,零学习成本,非常高效。并且支持在线分享接口文档。
(2)数据模型:可复用的数据结构,定义接口返回数据结构及请求参数数据结构(仅 JSON 和 XML 模式)时可直接引用。支持模型直接嵌套引用,直接 JSON/XML 智能导入,支持 oneOf、allOf 等高级组合模式。
(3)接口调试:Postman 有的功能,比如环境变量、前置/后置脚本、Cookie/Session 全局共享 等功能,Apifox 都有,并且比 Postman 更高效好用。接口运行完之后点击保存为用例按钮,即可生成接口用例,后续可直接运行接口用例,无需再输入参数,非常方便。自定义脚本 100% 兼容 Postman 语法,并且支持运行 javascript、java、python、php、js、BeanShell、go、shell、ruby、lua 等各种语言代码。
(4)接口用例:通常一个接口会有多种情况用例,比如参数正确用例、参数错误用例、数据为空用例、不同数据状态用例等等。运行接口用例时会自动校验数据正确性,用接口用例来调试接口非常高效。
(5)接口数据 Mock:内置Mock.js规则引擎,非常方便 mock 出各种数据,并且可以在定义数据结构的同时写好 mock 规则。支持添加“期望”,根据请求参数返回不同 mock 数据。最重要的是 Apifox 零配置 即可 Mock 出非常人性化的数据,具体在本文后面介绍。
(6)数据库操作:支持读取数据库数据,作为接口请求参数使用。支持读取数据库数据,用来校验(断言)接口请求是否成功。
(7)接口自动化测试:提供接口集合测试,可以通过选择接口(或接口用例)快速创建测试集。目前接口自动化测试更多功能还在开发中,敬请期待!目标是:JMeter 有的功能基本都会有,并且要更好用。
(8)快捷请求:类似 Postman 的接口调试方式,主要用途为临时调试一些无需文档化的接口,无需提前定义接口即可快速调试。
(9)代码生成:根据接口及数据数据模型定义,系统自动生成接口请求代码、前端业务代码及后端业务代码。(10)团队协作:Apifox 天生就是为团队协作而生的,接口云端实时同步更新,成熟的团队/项目/成员权限管理,满足各类企业的需求。
三. 下载
使用方法与本博主发的
《超详细的Postman接口测试全解(完整版)》一样
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)