This artifact greatly improves collaboration efficiency

I. Introduction

If a worker wants to do a good job, he must first sharpen his tools

Recently, I have been researching the software for API interface collaboration for a long time, and the software on the market has been downloaded and used for a round. Here is the most powerful "artifact" Apifox.

• Apifox official website: apifox.cn

Before introducing it, let's talk about a few scenarios. If you are backend, frontend or testing, you must have encountered these scenarios.

1.1. Scenario 1. Back-end perspective:

I am a backend and have encountered problems:

1. The interface is set, and the front-end and testing partners in the team come to me for documentation . If the code comments are good, it is easy to be complained about the ugly interface and weak functions. It cannot be used for parallel debugging in the development stage. It cannot be connected or debugged at the beginning, and sometimes even the front-end development interface will appear. Can wait for back-end joint debugging.
2. During the interface joint debugging and docking process, there will always be some unexpected interfaces. It is found that some fields return null or the type is incorrect , which will cause the front end to crash or the interface to display abnormally. During joint debugging, the interface bug is not easy to locate , etc.
3. The interface is initially connected, but there is no test data. The test buddy is a novice, let me make some data for her to test. Some complex process data is created through the database, which is thankless and prone to problems. Often the result is a backhand bug.
4. The company's interface is microservice-oriented. To open it to other business units or external customers, it needs to provide interface definitions, parameter descriptions, etc. Since then, there are more documents to maintain, and all subsequent iterations need to be synchronized .

1.2. Scenario 2. Front-end perspective:

我是个 前端 ，遇到过的问题：

1. 前端业务开发完，但是自测得依赖于接口数据来集合在前端（网页、客户端、小程序）来跑一整个流程。接口又还不能对接，可能要等几天甚至一周，就只能先自己 Mock 一些 JSON 数据 来自测，如果自己 造数据 的时候有些造的不太对，还得自己 定位查错是代码健壮性还是 JSON 本身造的问题 才能纠错，而且 webpack 或其他脚手架提供的 mock 服务往往 只能返回单一结果，想要 mock 多种情况非常麻烦 。
2. 后端开发完，联调却发现界面显示崩溃了，发现是 接口返回数据类型 和文档不一致，肉眼还分辨不出来，还得 费工夫调试 一轮下来才发现是接口问题。
3. 接口初步对通了，发现某些情况接口满足不了需求 需要加字段 ，后端要开发 0.5/1 天。要么干等进度延期，要么就提前同步去修改一下 Mock 的 JSON 数据 对应的改一下前端逻辑，往往有多套 JSON 还得全部同步改一遍。

1.3. 场景三、测试视角：

我是个 测试 ，遇到过的问题：

1. 负责接口测试时，不仅需要 花时间去思考接口的可能场景和手动造参数 到 JMeter 手动录入 ，往往一个接口变动还会引起 N 个用例的修改，费时间重复做接口同步的工作 。
2. 往往每个团队测试成员之间的断言总是最费时间维护的，其中涉及到 团队成员间的断言脚本同步 、 团队成员间的断言脚本同步，而且一个新的团队成员或团队人员的流动，还会伴随一段时间要带新人，手把手教人入门。
3. 测试接口测试时，对于一些性能问题或并发的问题不仅验证麻烦，还很容易，每个迭代回归测试要重复所有流程测试，然后 输出测试报告 。

这 3 个场景都反映了一个关键问题，工作效率低（PS：并不是单个人或单个角色的影响，而是因为协作不可避免的会影响到了所有人的效率）。

二、Apifox

Apifox 是 API 文档、API 调试、API Mock、API 自动化测试一体化协作平台，定位 Postman + Swagger + Mock + JMeter。通过一套系统、一份数据，解决多个系统之间的数据同步问题。只要定义好 API 文档，API 调试、API 数据 Mock、API 自动化测试就可以直接使用，无需再次定义；API 文档和 API 开发调试使用同一个工具，API 调试完成后即可保证和 API 文档定义完全一致。高效、及时、准确！

下面针对前言中的三个场景来聊聊。

2.1 场景一、后端视角：

漂亮的接口文档

定义一下参数、返回结构，即可生成的一份 漂亮的文档 。并且设计文档对项目已有接口还支持 swagger 导入、抓包 cURL 导入等多种方式批量创建。

返回结构示例，定义好结构没有接口也可以直接预览生成，也可以边调试可以边保存，不用手动维护。

自动校验数据

对于之前一些 字段返回 null 或 类型不正确 ，接口调试的时候，不需要写断言，即会自动通过文档定义对必须属性、可空、类型做校验，检查返回数据的正确与否，醒目提示。

状态码检查、枚举检查，字段类型、必要字段断言检查等各种检查都是自动的，不需要写 断言 。

调试直观反映问题，修改问题后数据校验通过。接口就这样自测完了，完美。

造种子数据

支持参数 mock 动态值，随机产生人性化请求参数，配置测试用例，一键批量造种子数据。

首先，通过表单选择一下 body 的动态值。

然后，运行查看下请求的实际 body 的随机值。

最后，一键导入用例到测试用例，不需要修改，直接设置轮次 5000，这就造了 5000 条随机数据了。

在线 API 接口文档

支持在线分享，可选密码访问，实时同步接口改动更新。

这是 Apifox 分享出来的 API 文档，贴个图你感受下：

返回体示例

Markdown 文档

2.2 场景二、前端视角：

Mock 服务

有了 Mock 服务或工具之后，前后端可以同步进入开发，后端接口出来之前，前端可以通过 Mock 功能来制造假数据接口来进行开发和调试。

Apifox 不仅自带 Mock 服务根据接口定义里的数据结构、数据类型返回 Mock 数据，还内置 智能 Mock 功能，随字段名和字段数据类型会智能优化自动匹配生成 mock 规则。大多数情况下能轻易实现 “零配置” Mock 出非常人性化的数据，只要文档定义完即可使用。

零配置的数据结构：

零配置的接口：

看看 Mock 出来的随机数据：

可以看出 Apifox 零配置 Mock 出来的数据和真实情况是非常接近的，前端开发可以直接使用，根本不用手动写 JSON 或 mock 规则。

还支持高级 Mock 功能，即定制返回的返回数据，根据不同的请求参数值返回不同的数据、Header 延迟等配置。

高级 Mock 功能里还支持在返回数据里部分的数据是随机动态值，支持使用 Mock.js、Nunjucks 两大利器。

联调前数据校验

后端开发完了进入联调阶段，直接可以使用后端开发已有的用例根据情况去修改参数。不仅工作量少，且简单错误都是直观展示，校验过一轮接口的稳定性，再也不用扯皮是不是接口已经 Ready 了。

接口变更、迭代，让我们 拥抱变化

接口返回体需要 增加一个字段返回 或接口需要 增加一个参数 ，所有调试用例、测试用例、 Mock 服务都自动会增加参数和返回值，根本不需要 费力手动 同步接口、返回体的功夫。

用户模型增加一个 updatedAt 字段，表示用户的信息更新时间

返回的 Mock 数据，自动新增带了这个字段的 Mock 数据，零维护同步成本

2.3 场景三、测试视角：

复用开发成果

Apifox 的测试用例直接可以复用开发的调试接口用例。

A new parameter is added to the interface userType, which will be automatically synchronized directly in the automated test use case, reducing unnecessary manual parameter synchronization.

A new field is added to the data structure name, photoUrlsand type and necessity assertions are automatically performed directly in all relevant automated test use cases. There is no need to locate the relevant use case scope affected by the change, and no manual assertion is required. The execution can locate the relevant failed use cases.

Automatic synchronization of test data between teams

Interface data, test scripts, and use case data can be shared within the team, and there is no need to manually synchronize by sharing files.

Test data synchronization, and support automatic switching management following the environment.

Configuration synchronization of test steps, interval time, threads, rounds, etc.

output test report

It supports multi-threading, multi-round and one-click execution of process test cases, and also supports the collection of all processes in the suite for full-process testing. Reports support exporting formats such as HTML, JSON, and console.

The test case is single-process, multi-threaded, and looped for multiple tests.

The test suite collects all the processes of the test case for full-process testing.

Continuous Integration Automated Interface Monitoring

Support continuous integration command line mode, combined with Jenkins to achieve automated interface monitoring, daily testing, etc.

3. Summary

These scenarios are often encountered in our team. Apifox can not only solve these problems very well, but also very easy to use, strong collaboration, and powerful, and it was quickly promoted in our team.

It is definitely the best interface management artifact. There is no one that kills all similar products on the market in seconds.

The installation of Apifox is very convenient, you can directly download the installation package from the official website and decompress it. Download address: www.apifox.cn/

It's not easy to code words, like, forward, and comment from friends who like it, thank you