为什么越来越多的人选择Apifox?

Dear 丶 2023-09-27 12:04 160阅读 0赞

![在这里插入图片描述][1127b99e7f1a4fe1a14253599e022188.gif_pic_center]

想必大部分人都用过PostMan软件，最近接触到一个很好用的软件:**Apifox**  
Apifox = Postman + Swagger + Mock + JMeter  
[戳我下载，推荐][Link 1]  
![在这里插入图片描述][576975fae4b047939916a2e3e924dfe0.png]

#### 文章目录 ####

*  一 Apifox
 *  二 .功能介绍
 *   *  在线调试
     *  自动生成
     *  生成请求代码
     *  生成模型代码
     *  API Hub
 *  三 Apifox 做的不仅仅是数据打通
 *   *  1、调试时自动校验数据结构
     *  2、数据模型定义、引用
     *  3、接口用例管理
     *  4、零配置 Mock 出非常人性化的数据
     *  5、代码自动生成
     *  6、导入、导出
 *  四 后续功能规划
 *  五 最佳实践

--------------------

## 一 Apifox ##

**Apifox = Postman + Swagger + Mock + JMeter**。集接口文档工具、接口 Mock 工具、接口自动化测试工具、接口调试工具于一体，提升 10 倍研发效率。

![f4436dfc16f0e56811a3d2252a2e22b4.png][]

在这些核心功能之外，Apifox 还提供了大量创新的围绕 API 的扩展特性，适合各种规模的开发团队使用。

![0859d8af4a982663ec0be7d1fa1b85eb.png][]

## 二 .功能介绍 ##

### 在线调试 ###

这个文档是用 **Apifox** 做的，我之前有试用过这个工具，完全免费不限功能的，没想到最近又有这么多厉害的新功能出来了。

点击文档右上角的**运行**按钮，就会出现“在线运行”的模块

![a56e6905389c92481a5f2d8d93abd953.png][]

这个界面上就能直接调试接口了！直接 1. 填参数，2. 选环境，3. 点发送，接口请求就发出去了！下面就有返回结果！根本用不着 Postman！更不用把 API 照着抄一遍！

![6654b190e3fa5e5c679fcd789cbbb372.png][]

### 自动生成 ###

只要把 Swagger 的 URL 填到 Apifox 里面去，Apifox 就会自动导入 API  
定义，然后就能生成这个好用的文档！

后端随便改代码，前端随时可以在线调试！

![4b4d0cfb9f9ea86fbb2ee239fc48c872.png][]

而且，还可以导入多个来源的 Swagger！一套接口文档来自多个不同的后端项目也没问题！

### 生成请求代码 ###

在这个在线文档页面上，还有一行熟悉的 icon。这是什么呢？

![a9bcccab5e605c0c7ea0bacfbeabf2cf.png][]

**自！动！生！成！代！码！**

点击对应的语言，就能直接生成请求的代码！？？？

我选择了 JavaScript 之后，居然还提供了 Fetch、Axios、Jquery 等等请求方式的代码？？？

![f4e3c025c95642814377eb75ac16e517.png][]

### 生成模型代码 ###

API 文档嘛，都会有个“返回响应”的模块，就是告诉你后端吐出来的数据是什么类型什么长度等等。前端再写个数据结构把这些数据接着，然后放进页面里去。

在这个神仙文档里呢，“返回响应”里也有个“生成代码”。

![2292316f32d379d24f45e9d18efb664b.png][]

我点了一下，就弹出了这个框：

![281433d6cb53959756725fcc4c463f04.png][]

左边还可以选择你生成代码的配置，包括：**编程语言、命名风格、校验开启**等等。

我看了看，Java，C，C++，JS，Swift，Go，Python，TypeScript……基本上我知道的语言全都有。

### API Hub ###

![eac0ff96291f636ea3db60a7459bd458.png][]

在 Apifox 里面，已经把这些最常用的第三方 API 都做好了！即时通讯的，电商的，查快递的，项目管理的，统统都有！每一个都可以**在线运行**！**生成代码**！也可以克隆到自己的项目里，然后用**云端 Mock**！

![企业微信的 API 文档，可以在线运行][API]

![79e2dbc8ee1a7d1d1eebfcce09d53ed0.png][]

我看他们官方还有预告，后续会支持更强大的文档功能，包括**自定义域名、自定义导航、多主题样式选择、自定义 css、自定义页面**等等这些，你们都要关注一下。

## 三 Apifox 做的不仅仅是数据打通 ##

如果你认为 Apifox 只做了数据打通，来提升研发团队的效率，那就错了。Apifox 还做了非常多的创新，来提升开发人员的效率。

### 1、调试时自动校验数据结构 ###

使用 Apifox 调试接口的时候，系统会根据接口文档里的定义，自动校验返回的数据结构是否正确，无需通过肉识别，也无需手动写断言脚本检测，非常高效！  
![在这里插入图片描述][2dbe442edf0d438a8bc7258daba9a1e0.png]

### 2、数据模型定义、引用 ###

可以独立定义数据模型，接口定义时可以直接引用数据模型，数据模型之间也可以相互引用。同样的数据结构，只需要定义一次即可多处使用；修改的时候只需要修改一处，多处实时更新，避免不一致。

### 3、接口用例管理 ###

通常一个接口会有多种情况用例，比如 正确用例 参数错误用例 数据为空用例 不同数据状态用例。定义接口的时候定义好这些不同状态的用例，接口调试的时候直接运行，非常高效。

### 4、零配置 Mock 出非常人性化的数据 ###

先放一张图对比下 Apifox 和其他同类工具 零配置 mock 出来的数据效果：  
![在这里插入图片描述][0f96ca0765b9495697cabcd6946e9182.png]  
![在这里插入图片描述][2f475400a62b4e1ab6d83f74d3cc8797.png]  
可以看出 Apifox 零配置 Mock 出来的数据和真实情况是非常接近的，前端开发可以直接使用，而无需再手动写mock规则。  
Apifox 如何做到高效率、零配置生成非常人性化的 mock 数据：

1.  Apifox 根据接口定义里的数据结构、数据类型，自动生成 mock 规则。
2.  Apifox 内置智能 mock 规则库，根据字段名、字段数据类型，智能优化自动生成的 mock 规则。如：名称包含字符串image的string类型字段，自动 mock 出一个图片地址 URL；包含字符串time的string类型字段，自动 mock 出一个时间字符串；包含字符串city的string类型字段，自动 mock 出一个城市名。
3.  Apifox 根据内置规则，可自动识别出图片、头像、用户名、手机号、网址、日期、时间、时间戳、邮箱、省份、城市、地址、IP等字段，从而 Mock 出非常人性化的数据。
4.  除了内置 mock 规则，用户还可以自定义规则库，满足各种个性化需求。支持使用 正则表达式、通配符 来匹配字段名自定义 mock 规则。

### 5、代码自动生成 ###

根据接口模型定义，自动生成各种语言/框架（如 TypeScript、Java、Go、Swift、ObjectiveC、Kotlin、Dart、C++、C\#、Rust 等）的业务代码（如 Model、Controller、单元测试代码等）和接口请求代码。目前 Apifox 支持 130 种语言及框架的代码自动生成。

更重要的是：你可以通过自定义代码模板来生成符合自己团队的架构规范的代码，满足各种个性化的需求。

### 6、导入、导出 ###

支持导出 OpenApi (原Swagger)、Markdown、Html 等数据格式，因为可以导出OpenApi格式数据，所以你可以利用 OpenApi (Swagger) 丰富的生态工具完成各种接口相关的事情。  
支持导入 OpenApi (原Swagger)、Postman、HAR、RAP2、yapi、Eolinker、DOClever、ApiPost 、Apizza 等数据格，方便迁移旧项目。

## 四 后续功能规划 ##

1.接口性能测试支持（类似 JMeter）；

2.支持插件市场，可以自己开发插件；

3.开放 Apifox API，允许开发者通过 API 调用 Apifox 的功能；

4.支持更多接口协议，如GraphQL、gRPC、websocket等；

5.支持离线使用，项目可选择在线同步（团队协作）还是仅本地存储（单机离线使用）；

## 五 最佳实践 ##

1.前端（或后端）：在 Apifox 上定好接口文档初稿。

2.前后端：一起评审、完善接口文档，定好接口用例。

3.前端：使用系统根据接口文档自动生成的 Mock 数据进入开发，无需手写 mock 规则。

4.后端：使用接口用例 调试开发中接口，只要所有接口用例调试通过，接口就开发完成了。如开发过中接口有变化，调试的时候就自动更新了文档，零成本的保障了接口维护的及时性。

5.后端：每次调试完一个功能就保存为一个接口用例。

6.测试人员：直接使用接口用例测试接口。

7.所有接口开发完成后，测试人员（也可以是后端）使用集合测试功能进行多接口集成测试，完整测试整个接口调用流程。

8.前后端 都开发完，前端从Mock 数据切换到正式数据，联调通常都会非常顺利，因为前后端双方都完全遵守了接口定义的规范。

[1127b99e7f1a4fe1a14253599e022188.gif_pic_center]: https://img-blog.csdnimg.cn/1127b99e7f1a4fe1a14253599e022188.gif#pic_center
[Link 1]: http://apifox.cn/a103aoye
[576975fae4b047939916a2e3e924dfe0.png]: https://img-blog.csdnimg.cn/576975fae4b047939916a2e3e924dfe0.png
[f4436dfc16f0e56811a3d2252a2e22b4.png]: https://img-blog.csdnimg.cn/img_convert/f4436dfc16f0e56811a3d2252a2e22b4.png
[0859d8af4a982663ec0be7d1fa1b85eb.png]: https://img-blog.csdnimg.cn/img_convert/0859d8af4a982663ec0be7d1fa1b85eb.png
[a56e6905389c92481a5f2d8d93abd953.png]: https://img-blog.csdnimg.cn/img_convert/a56e6905389c92481a5f2d8d93abd953.png
[6654b190e3fa5e5c679fcd789cbbb372.png]: https://img-blog.csdnimg.cn/img_convert/6654b190e3fa5e5c679fcd789cbbb372.png
[4b4d0cfb9f9ea86fbb2ee239fc48c872.png]: https://img-blog.csdnimg.cn/img_convert/4b4d0cfb9f9ea86fbb2ee239fc48c872.png
[a9bcccab5e605c0c7ea0bacfbeabf2cf.png]: https://img-blog.csdnimg.cn/img_convert/a9bcccab5e605c0c7ea0bacfbeabf2cf.png
[f4e3c025c95642814377eb75ac16e517.png]: https://img-blog.csdnimg.cn/img_convert/f4e3c025c95642814377eb75ac16e517.png
[2292316f32d379d24f45e9d18efb664b.png]: https://img-blog.csdnimg.cn/img_convert/2292316f32d379d24f45e9d18efb664b.png
[281433d6cb53959756725fcc4c463f04.png]: https://img-blog.csdnimg.cn/img_convert/281433d6cb53959756725fcc4c463f04.png
[eac0ff96291f636ea3db60a7459bd458.png]: https://img-blog.csdnimg.cn/img_convert/eac0ff96291f636ea3db60a7459bd458.png
[API]: https://img-blog.csdnimg.cn/img_convert/8be6d60ed0bebfece6b196176f5a2e5d.png
[79e2dbc8ee1a7d1d1eebfcce09d53ed0.png]: https://img-blog.csdnimg.cn/img_convert/79e2dbc8ee1a7d1d1eebfcce09d53ed0.png
[2dbe442edf0d438a8bc7258daba9a1e0.png]: https://img-blog.csdnimg.cn/2dbe442edf0d438a8bc7258daba9a1e0.png
[0f96ca0765b9495697cabcd6946e9182.png]: https://img-blog.csdnimg.cn/0f96ca0765b9495697cabcd6946e9182.png
[2f475400a62b4e1ab6d83f74d3cc8797.png]: https://img-blog.csdnimg.cn/2f475400a62b4e1ab6d83f74d3cc8797.png