Apifox断言配置教程

穿越時空

穿越時空

2026-06-23

287人浏览

原创

apifox中需在【后置操作】添加断言实现自动校验:1.状态码校验选http code等于200;2.json字段校验用$.success等于true;3.嵌套字符串校验用$.message等于"success";还可通过自定义脚本灵活校验多字段。

apifox断言配置教程 - php中文网

你需要在Apifox中让接口返回结果自动校验是否符合预期,比如状态码是不是200、业务字段success是否为true、message提示是否等于"Success",而不是每次手动翻看响应体逐字比对。

添加断言的入口位置

打开目标接口 → 点击右侧【后置操作】标签页 → 点击【添加后置操作】按钮 → 在弹出菜单中选择【断言】。

注意:断言必须放在【后置操作】里,不能在【前置操作】或请求参数区域设置,否则不会执行校验逻辑。

用图形化方式快速配置3个常用断言

方法一:状态码校验

点击【添加断言】→ 断言名称填“状态码 200” → 断言对象选【HTTP Code】→ 比较方式选【等于】→ 预期值填【200】。

方法二:JSON字段值校验

点击【添加断言】→ 断言名称填“操作成功” → 断言对象选【Response JSON】→ 路径/方式填【$.success】→ 预期值填【true】(不加引号)。

方法三:嵌套字段字符串校验

点击【添加断言】→ 断言名称填“提示信息正确” → 断言对象选【Response JSON】→ 路径/方式填【$.message】→ 预期值填【"Success"】(必须带英文双引号,否则校验失败)。

Apifox(接口调试工具)
Apifox(接口调试工具)

Apifox是一款拥有可视化管理界面的接口开发调试工具,支持接口调试,自动校验数据结构,自动化测试等功能,能够帮助用户更好的测试API,能够有效提高团队的办公效率,有需要的用户欢迎下载使用!功能介绍可视化接口管理方便快捷可视化接口管理,成倍提升团队多人协作效率。支持数据结构(JSON Schema)管理,多接口可复用相同数据结构。接口调试Postman 有的功能,比如环境变量、预执行脚本、后执行脚本、Cookie/Session 全局共享 等功能,Apifox 都有,并且和 Postman 一样高效好用。

下载

用自定义脚本写更灵活的断言

第一步:切换到【后置操作】→ 点击【添加后置操作】→ 选择【自定义脚本】。

第二步:粘贴以下代码(直接复制即可,无需修改):

// 验证HTTP状态码
// 验证业务字段code是否为200
// 验证message是否包含"Success"

pm.test("Status code is 200", () => {
  pm.response.to.have.status(200);
});

pm.test("Business code is 200", () => {
  const jsonData = pm.response.json();
  pm.expect(jsonData.code).to.equal(200);
});

pm.test("Message contains Success", () => {
  pm.expect(pm.response.text()).to.include("Success");
});

这三段脚本会分别校验状态码、JSON中的code字段、响应体文本是否含指定字符串。其中【pm.response.json()】要求响应体必须是合法JSON格式,否则脚本会直接报错中断执行。

动态提取并校验多个字段值

适用场景:你不知道接口返回的字段名是data还是result,或者字段层级可能变化,但总有一个非空数值字段需要校验。

在【自定义脚本】中写入:

const res = pm.response.json();
const keys = Object.keys(res);
for (let key of keys) {
  if (typeof res[key] === 'number' && res[key] > 0) {
    pm.test(`字段 ${key} 是正数`, () => {
      pm.expect(res[key]).to.be.above(0);
    });
    break;
  }
}

这段脚本会遍历第一层所有键,找到第一个类型为number且大于0的值,立即对该字段做断言并退出循环。它不依赖固定路径,适合字段结构不稳定的测试场景。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

apifox

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Apifox接口调试教程大全
Apifox接口调试教程大全

Apifox接口调试专题覆盖 HTTP 请求发送、请求头、Query参数、Body请求体、Cookie、鉴权、响应校验、前置脚本、后置脚本和接口用例管理,帮助开发和测试人员在同一工具中完成接口调试、问题定位和前后端联调,减少 Postman 与文档工具之间的数据重复维护。

2026.06.23

41

10

Apifox自动化测试教程
Apifox自动化测试教程

Apifox自动化测试专题围绕接口测试场景编排、测试步骤、断言、变量提取、数据驱动、数据库校验、测试报告和 Apifox CLI 持续集成展开,适合测试工程师和研发团队构建 API 回归测试流程,并与 Jenkins、GitLab CI 等流水线结合提升接口质量保障效率。

2026.06.23

60

10

Apifox迁移协作指南
Apifox迁移协作指南

Apifox迁移协作专题覆盖 Swagger、OpenAPI、Postman、YApi、Eolink、Knife4j、HAR 等数据导入导出,讲解团队权限、项目成员、接口变更同步、数据备份、私有化部署和企业协作管理,适合从旧接口工具迁移到 Apifox 的团队规划统一 API 管理平台。

2026.06.24

48

10

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

9

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

6

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

8

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

4

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

3

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apifox CLI官方手册
Apifox CLI官方手册

共0课时 | 0人学习

Apifox下载与安装手册
Apifox下载与安装手册

共0课时 | 0人学习

Apifox官方手册
Apifox官方手册

共0课时 | 0人学习