autorenew

更新时间: 2026-03-25

api-test-pytest

基础信息

Skill 名称
api-test-pytest
中文名称
api-test-pytest
作者
naodeng
适用场景
接口改动可能影响契约、鉴权、数据结构或上下游集成。
适用人群
接口测试工程师、后端测试和自动化同学。
简单介绍
适合谁:接口测试工程师、后端测试和自动化同学。 何时使用:接口改动可能影响契约、鉴权、数据结构或上下游集成。 怎么使用:先定接口测试矩阵,再执行契约与行为验证,最后输出可复现问题证据。

Skill 完整介绍

When 定场景:触发场景,用户何时使用

  • 接口改动可能影响契约、鉴权、数据结构或异常处理。
  • 前端未就绪但后端已可测,需要先做接口质量把关。
  • 发版前要确认上下游集成风险。

What 立目标:具体成果,解决什么问题

  • 使用基于 pytest 的接口自动化与分层断言完成关键接口验证。
  • 发现契约不一致、状态码漂移、数据完整性问题。
  • 为接口可发布性和集成安全提供证据。

How 理规则:步骤逻辑,怎么执行

  1. 按业务关键链路确定接口测试范围。
  2. 设计测试矩阵:主流程、参数校验、鉴权、幂等、边界数据。
  3. 使用稳定数据与隔离环境执行测试。
  4. 校验状态码、响应结构、关键字段和副作用。
  5. 记录失败请求、复现条件和关联日志。
  6. 汇总接口质量结论:通过率、主要风险、后续动作。

Reference 给示例:正例(输入 -> 输出)

输入:

  • 接口:POST /orders
  • 规则:会员券、库存锁定、超时回滚

输出:

  • 覆盖正常下单、无效券、库存不足、重放保护
  • 发现支付超时后未正确回滚
  • 建议修复前阻塞发版

Reference 给示例:反例(输入 -> 输出)

输入:

  • “把订单接口都测一遍”

输出(问题):

  • 只校验 200 返回,没有结构和异常路径验证
  • 字段类型变更这类破坏性问题会漏掉

Limits 画边界:明确限制,什么不做

  • 不在环境和数据前提不清晰时开测。
  • 不仅靠状态码判断接口正确性。
  • 不忽略写接口的副作用验证。
  • 不掩盖由数据不稳定导致的假失败。
  • 不在无契约校验时宣称“可安全集成”。

使用说明

  1. 先完成 api-test-pytest 的安装和启用(直接用本页安装命令)。
  2. 提需求时先给必要上下文:范围、环境、时间、期望输出格式。
  3. 带接口背景触发,例如:“使用 api-test-pytest 覆盖 staging 的 /orders 和 /payments。”
  4. 提供鉴权和数据前提,并要求输出测试矩阵、断言项、缺陷证据格式。
  5. 分两轮执行:先冒烟,再异常/边界回归。

安装说明

平台

AI 工具

快速安装(一行命令)

正在生成命令...

完整脚本

正在加载脚本...
分享