当前位置:首页 » 《随便一记》 » 正文

用了国产接口管理神器 Apifox 之后,我果断从 Postman “脱坑”了

2 人参与  2022年08月26日 08:59  分类 : 《随便一记》  评论

点击全文阅读



在这里插入图片描述

本文导读

一、认识 Apifox1. 为什么要使用 Apifox 工具2. Apifox 有哪些功能3. API First 理念下的开发流程 二、上手操作 Apifox1. 安装 Apifox2. 团队管理&项目管理3. 编写接口文档4. 智能 Mock 数据5. 在线分享 API 文档6. 自动化测试7. API Hub 三、Apifox 电梯直达


一、认识 Apifox

1. 为什么要使用 Apifox 工具

在当前行业发展背景下,绝大部分项目都是基于 前后端分离 的架构进行的,由前后端、测试、运维等不同的团队共同开发,那么团队之间能否很好的 协同合作 无疑直接决定着项目的最终效果。而协作其实也是大多数开发团队的痛点,为了便于团队协作,也出现了一些研发管理工具诸如 Jira、Teambition,应用也比较广泛,它们主要将功能聚焦于项目管理、代码托管、缺陷跟踪等环节。

但是在实际开发流程中,团队之间的协同是很低效的,比如需求评审结束之后,前后端进行接口定义并派一名工程师来定义 API 文档(一般使用 Swagger);随后进入开发流程,后端按照 API 文档开发接口,在调试时还需按照文档在 Postman 中重新定义一遍;在后端开发出接口之前,前端如果需要开发就得按照 API 文档自己去 Mock 数据,也就是在 Mock.js 中重新写一遍接口定义和 Mock 规则;测试在接口开发完成之前需要按照文档到 JMeter 中写测试用例,难免的又得写一遍接口定义;

在这里插入图片描述

可以看到整个开发过程都是围绕 API 开展的,在这个过程中不同团队都需要对接口的定义进行操作,这会导致在联调时极易出现定义不一致等诸多问题。而且还用到了不同的工具如 Swagger、Postman、Mock、JMeter,明显造成了很多资源的浪费和低效使用。

而 Apifox 的诞生正是为了解决以上问题,Apifox 的研发宗旨—— 节省研发团队的每一分钟

2. 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。

3. API First 理念下的开发流程

Apifox 秉承的是 API first(API 优先)的先进理念,也就是开发团队首先制定 API,然后围绕 API 展开设计和开发。使用 Apifox 之后,开发效率会大大提升且各方工作体验更好,与外部团队的协作也会更加顺畅。在此理念下的开发流程是这样的:

开发阶段工作任务
设计阶段根据需求文档确定接口设计思路,接口设计者设计好接口初稿,然后前后端一起评审接口,完善接口文档。
开发阶段前端:Apifox 会根据接口文档自动生成 Mock 数据,直接进入开发过程无需手写 Mock 规则。
后端:使用 Apifox 根据接口定义调试接口,即使在开发过程中接口有变化,调试时修改接口定义就可以自动更新文档。
测试:使用后端调试时保存的接口用例生成测试用例。
联调和测试阶段此时所有接口开发完成,测试/后端使用集合测试功能进行多借口集成测试。

二、上手操作 Apifox

1. 安装 Apifox

直接官网下载 Apifox 即可,可以支持 Windows、mac、Linux 三个平台,也可以直接使用网页版;

在这里插入图片描述
下载完成依次点击“下一步”即可安装,首次启动软件需要进行注册登录。

在这里插入图片描述
初始界面如下:

在这里插入图片描述

2. 团队管理&项目管理

点击 “新建团队” 进行创建;

在这里插入图片描述

创建成功如下,在团队中可以新建项目、添加成员和权限授予等操作;

在这里插入图片描述

接下来新建一个项目;

在这里插入图片描述

点击项目进入后如下,可对此项目进行、接口管理、自动化测试、项目设置和邀请成员等相关操作;

在这里插入图片描述

3. 编写接口文档

点击“+” --> “新建接口”;

如下是我新建的一个登录接口示例:

接口地址、接口基本信息
在这里插入图片描述

请求参数设置
在这里插入图片描述

接口响应设置
在这里插入图片描述

设置完相关属性之后,点击保存,此时就会生成一个基于 Apifox 的接口文档,可以看到还可以运行此接口或者直接生成代码操作;

在这里插入图片描述

4. 智能 Mock 数据

可以看到在文档中有一个 Mock 区域,包含 Mock url;

在这里插入图片描述

我们复制此 mock 地址,在浏览器打开,便可以直接访问到 mock 数据;

在这里插入图片描述

在 API 文档设定好之后就可以直接用这个 Mock 地址来做开发了。

5. 在线分享 API 文档

点击“项目概览”,新建在线分享;

在这里插入图片描述

设定分享对象等参数;

在这里插入图片描述

随后便可以复制链接进行分享了;

在这里插入图片描述

查看链接效果如下;

在这里插入图片描述

6. 自动化测试

在进行自动化测试之前,我们先将当前的接口文档保存为用例,方便后面直接将接口用例导入自动化测试。

在这里插入图片描述

点击“自动化测试” --> “测试用例” --> “创建” 新建测试用例;

在这里插入图片描述

创建成功后点击用例进入,如下;

在这里插入图片描述

点击 “添加步骤”,然后选择 “从【接口用例导入】”;

在这里插入图片描述

用例导入后如下;

在这里插入图片描述

此时可以设置相关的运行属性包括运行环境、线程数等,也可以测试数据,这里支持导入 CSV 或者手动添加数据集。

在这里插入图片描述

最后点击 “运行” 进行测试;

在这里插入图片描述

7. API Hub

Apifox 为我们提供了市面上最常用的各种 API,可以方便的直接使用并且一键调试。

点击 “切换项目”,然后选择 API Hub,如下;

在这里插入图片描述

点击进入一个 API,我们便可以选择接口进行调试和运行;

在这里插入图片描述

三、Apifox 电梯直达

Apifox 作为一款 完全免费 的国产软件,注册登录即可使用。具体怎么样只有各位小伙伴上手用了才知道。软件下载和学习均请前往 Apifox 官方网站:www.apifox.cn。

在这里插入图片描述


以上就是小马对 Apifox 的部分总结,由于时间、篇幅等原因这里只演示 Apifox 的一小部分功能,展示一些最为常用的操作带大家入门,更多深入好用的功能还是得大家亲自上手去发掘,相信你会实践中发现 Apifox 的真正强大之处。


点击全文阅读


本文链接:http://zhangshiyu.com/post/44728.html

<< 上一篇 下一篇 >>

  • 评论(0)
  • 赞助本站

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。

关于我们 | 我要投稿 | 免责申明

Copyright © 2020-2022 ZhangShiYu.com Rights Reserved.豫ICP备2022013469号-1