目录

Apifox简介

Apifox的安装与使用

Apifox新建项目的流程

编写接口文档


Apifox简介

我们在日常编程开发过程中经常实行的是前后端分离架构的模式,一个项目的落地会通过产品、开发、测试三方会审,对项目需求评审过后,前后端开发会制定一些接口,他们通常会用以下方式:

开发指定接口文档(Reg)。

后端开发依据接口文档开发接口,一边开发一边测试(Postman)。

前端开发需要(Mock)数据供前端调用。

开发完成后,测试通过(PostmanJmeter)去进行接口测试。

为了能让各个产品项目负责人落地更加便捷,Apifox应运而生实现了API设计开发测试一体化协作。俗称:Apifox=Postman+Swagger+Jmeter+Mock工具集。简而言之:开发人员在Apifox里定接口、前端直接根据Apifox去Mock数据、后端开发直接在Apifox进行调试、测试人员直接在Apifox的接口文档里面写用例、接下来就是前后端进行联调。

Apifox的安装与使用

安装的话就很简单了,百度搜索 Apifox ,或点击右侧的网址 Apifox网址 ,进入网址选择自己电脑适配的系统以及需求进行选择使用。

Apifox:详细使用教程,带你轻松拿捏

这边我电脑是 win64 ,所有这边我下载了桌面版64位,下载完成傻瓜式安装即可。安装完成进行注册登录,登录完成你会看到界面有一个个人项目,里面有一个项目案例给你简单介绍一下这个根据的简单使用。

Apifox:详细使用教程,带你轻松拿捏

给你一个简单的案例,呈现页面会出现哪些信息,让你初步了解一下。

Apifox:详细使用教程,带你轻松拿捏

对于页面的风格自己也可以进行设置, 打开设置对页面的主题颜色和字体大小可以自定义,还有一些其他的网络代理、证书代理调配等。

Apifox:详细使用教程,带你轻松拿捏

Apifox新建项目的流程

点击新建团队,创建新项目。

Apifox:详细使用教程,带你轻松拿捏

输入自己的团队名称,点击保存。

Apifox:详细使用教程,带你轻松拿捏

进入自己保存的团队:可以新建项目、可以定向邀请成员协同操作、可以修改团队名称移交或解散团队。

Apifox:详细使用教程,带你轻松拿捏

接下来新建项目,输入名称,项目图标自定,如果第一次使用可以允许包含示例数据,因为我这里没有定向邀请其他成员,项目中就只有我一个人,点击确认即可。

Apifox:详细使用教程,带你轻松拿捏

点击确认之后跳转到如下界面,因为上面我同意包含示例数据,所有在项目概览中的项目统计上数字不为0, 当前的项目可进行的操作很多,如下:

Apifox:详细使用教程,带你轻松拿捏

编写接口文档

基本信息填写

点击新建接口,进行编写接口文档。

Apifox:详细使用教程,带你轻松拿捏

因为本人服务器停运,这里借助黑马程序员某位老师的接口进行展示(doge),这里填写最基本的信息。

Apifox:详细使用教程,带你轻松拿捏

确认信息无误后点击保存即可。

Apifox:详细使用教程,带你轻松拿捏

params参数设置

params参数有两种方式,一种是 url后面?之后的参数;另一种是 url中的{参数名}参数。

Apifox:详细使用教程,带你轻松拿捏

Apifox:详细使用教程,带你轻松拿捏

Body参数

Body参数可以根据自己的需求上传不同格式的文件信息。

Apifox:详细使用教程,带你轻松拿捏

这里借用上文提到的接口简单的演示一下,转成json格式的数据是什么样的。这个工具会将我们的数据自动解析并识别成json格式。

Apifox:详细使用教程,带你轻松拿捏

我们可以将自己接口上的list添加一下新的东西来验证返回成功的200数据,如下:

Apifox:详细使用教程,带你轻松拿捏

将响应成功的案例自动生成在下面:

Apifox:详细使用教程,带你轻松拿捏

为了方便区别自己的接口是否成功写入,可以写入一个错误的响应以及案例来进行区别,可以将错误的响应里面的内容删除一点,并根据错误的响应生成一个异常示例:

Apifox:详细使用教程,带你轻松拿捏

Apifox:详细使用教程,带你轻松拿捏

修改文档完成点击保存并点击运行进入运行页面,点击自动生成的数据,点击发送即可

Apifox:详细使用教程,带你轻松拿捏

没有问题点击保存为用例

Apifox:详细使用教程,带你轻松拿捏

也可以设置特殊情况,来保存成为错误的用例

Apifox:详细使用教程,带你轻松拿捏

也可以给测试的数据添加一些动态值来更好的处理一些情况

Apifox:详细使用教程,带你轻松拿捏

后置操作获取token值

我们在进行登录接口的测试时,可以通过后置操作获取其相应的token值,其操作和上文一样,编写相应的接口文档

Apifox:详细使用教程,带你轻松拿捏

Apifox:详细使用教程,带你轻松拿捏

通过后置操作获取其token值

Apifox:详细使用教程,带你轻松拿捏

Apifox:详细使用教程,带你轻松拿捏

Apifox的其他功能

环境变量、全局变量、临时变量、动态变量、随机参数、自动化字段、socket接口、团队管理、导入导出、MOCK、脚本开发、自动化执行、Jenkins持续集成等

总结

总的来说,Apifox这个工具的功能性还是很强大的,很多企业也开始使用这个工具,对于程序员来说,不善于接触新事物对自身的发展是不利的,这篇文章主要介绍了这个工具的基本使用,还有很多强大的功能没有在此体现出来,还是需要各位在工作中慢慢发掘。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。