但是在实际开发流程中,团队之间的协同是很低效的,比如需求评审结束之后,前后端进行接口定义并派一名工程师来定义 API 文档(一般使用 Swagger);随后进入开发流程,后端按照 API 文档开发接口,在调试时还需按照文档在 Postman 中重新定义一遍;在后端开发出接口之前,前端如果需要开发就得按照 API 文档自己去 Mock 数据,也就是在 Mock.js 中重新写一遍接口定义和 Mock 规则;测试在接口开发完成之前需要按照文档到 JMeter 中写测试用例,难免的又得写一遍接口定义;
可以看到整个开发过程都是围绕 API 开展的,在这个过程中不同团队都需要对接口的定义进行操作,这会导致在联调时极易出现定义不一致等诸多问题。而且还用到了不同的工具如 Swagger、Postman、Mock、JMeter,明显造成了很多资源的浪费和低效使用。
而 Apifox 的诞生正是为了解决以上问题,Apifox 的研发宗旨—— 节省研发团队的每一分钟。
针对以上问题,Apifox 也确实提出了实际的解决方案,在 Apifox 官网中展示着这么一句话 Apifox = Postman + Swagger + Mock + JMeter,也就是将这四个开发工具的核心功能综合到了一起,使得前端、后端、测试均可方便定义和使用 API,避免工作的大量重复,最重要的是关于 API 的任何调整都可以实时同步到各个团队,保证项目过程中各个环节的一致性。
除此之外,Apifox 还具有以下丰富的功能:
API 文档:可视化的接口文档管理,支持数据结构定义,多接口复用相同数据结构,接口文档遵循 OpenAPI 规范,支持接口文档在线分享。
API 调试:拥有 Postman 的所有功能,更好用,可自动校验数据结构,自动发现接口异常。
API 自动化测试:完善的接口场景测试功能,支持调用其他编程语言。
API 数据 Mock:零配置即可 Mock 出非常人性化的数据,内置 mock.js 规则引擎,支持自定义期望。
CI 持续集成:支持命令行方式运行接口测试,支持集成 Jenkins 等持续集成工具。
数据库操作:支持数据库的读取与接口校验。
自动生成代码。
数据导入/导出:支持导入/导出十多种数据格式。
团队协作。
…
更多详细功能请参见 Apifox 官网 www.apifox.cn。
Apifox 秉承的是 API first(API 优先)的先进理念,也就是开发团队首先制定 API,然后围绕 API 展开设计和开发。使用 Apifox 之后,开发效率会大大提升且各方工作体验更好,与外部团队的协作也会更加顺畅。在此理念下的开发流程是这样的:
开发阶段 工作任务
设计阶段 根据需求文档确定接口设计思路,接口设计者设计好接口初稿,然后前后端一起评审接口,完善接口文档。
开发阶段 前端:Apifox 会根据接口文档自动生成 Mock 数据,直接进入开发过程无需手写 Mock 规则。
后端:使用 Apifox 根据接口定义调试接口,即使在开发过程中接口有变化,调试时修改接口定义就可以自动更新文档。
测试:使用后端调试时保存的接口用例生成测试用例。
联调和测试阶段 此时所有接口开发完成,测试/后端使用集合测试功能进行多借口集成测试。
直接官网下载 Apifox 即可,可以支持 Windows、mac、Linux 三个平台,也可以直接使用网页版;
下载完成依次点击“下一步”即可安装,首次启动软件需要进行注册登录。
初始界面如下:
点击 “新建团队” 进行创建;
创建成功如下,在团队中可以新建项目、添加成员和权限授予等操作;
接下来新建一个项目;
点击项目进入后如下,可对此项目进行、接口管理、自动化测试、项目设置和邀请成员等相关操作;
如下是我新建的一个登录接口示例:
接口地址、接口基本信息
设置完相关属性之后,点击保存,此时就会生成一个基于 Apifox 的接口文档,可以看到还可以运行此接口或者直接生成代码操作;
可以看到在文档中有一个 Mock 区域,包含 Mock url;
我们复制此 mock 地址,在浏览器打开,便可以直接访问到 mock 数据;
在 API 文档设定好之后就可以直接用这个 Mock 地址来做开发了。
点击“项目概览”,新建在线分享;
设定分享对象等参数;
在进行自动化测试之前,我们先将当前的接口文档保存为用例,方便后面直接将接口用例导入自动化测试。
点击“自动化测试” --> “测试用例” --> “创建” 新建测试用例;
创建成功后点击用例进入,如下;
点击 “添加步骤”,然后选择 “从【接口用例导入】”;
此时可以设置相关的运行属性包括运行环境、线程数等,也可以测试数据,这里支持导入 CSV 或者手动添加数据集。
最后点击 “运行” 进行测试;
Apifox 作为一款 完全免费 的国产软件,注册登录即可使用。具体怎么样只有各位小伙伴上手用了才知道。软件下载和学习均请前往 Apifox 官方网站:www.apifox.cn。