更新时间: 2026-03-25
api-test-bruno
基础信息
Skill 完整介绍
When 定场景:触发场景,用户何时使用
- 接口改动可能影响契约、鉴权、数据结构或异常处理。
- 前端未就绪但后端已可测,需要先做接口质量把关。
- 发版前要确认上下游集成风险。
What 立目标:具体成果,解决什么问题
- 使用基于 Bruno 的接口集合执行与脚本校验完成关键接口验证。
- 发现契约不一致、状态码漂移、数据完整性问题。
- 为接口可发布性和集成安全提供证据。
How 理规则:步骤逻辑,怎么执行
- 按业务关键链路确定接口测试范围。
- 设计测试矩阵:主流程、参数校验、鉴权、幂等、边界数据。
- 使用稳定数据与隔离环境执行测试。
- 校验状态码、响应结构、关键字段和副作用。
- 记录失败请求、复现条件和关联日志。
- 汇总接口质量结论:通过率、主要风险、后续动作。
Reference 给示例:正例(输入 -> 输出)
输入:
- 接口:
POST /orders - 规则:会员券、库存锁定、超时回滚
输出:
- 覆盖正常下单、无效券、库存不足、重放保护
- 发现支付超时后未正确回滚
- 建议修复前阻塞发版
Reference 给示例:反例(输入 -> 输出)
输入:
- “把订单接口都测一遍”
输出(问题):
- 只校验 200 返回,没有结构和异常路径验证
- 字段类型变更这类破坏性问题会漏掉
Limits 画边界:明确限制,什么不做
- 不在环境和数据前提不清晰时开测。
- 不仅靠状态码判断接口正确性。
- 不忽略写接口的副作用验证。
- 不掩盖由数据不稳定导致的假失败。
- 不在无契约校验时宣称“可安全集成”。
使用说明
- 先完成
api-test-bruno的安装和启用(直接用本页安装命令)。 - 提需求时先给必要上下文:范围、环境、时间、期望输出格式。
- 带接口背景触发,例如:“使用
api-test-bruno覆盖 staging 的 /orders 和 /payments。” - 提供鉴权和数据前提,并要求输出测试矩阵、断言项、缺陷证据格式。
- 分两轮执行:先冒烟,再异常/边界回归。
安装说明
平台
AI 工具
快速安装(一行命令)
正在生成命令... 完整脚本
正在加载脚本...