API 接口测试
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fa905b36/api-testing。
技能介绍
要解决什么问题
E2E 能走通页面,不代表接口在鉴权、幂等、并发写和错误码上靠得住。团队手头常有 OpenAPI/Swagger 和带 execution_model 的用例 Schema,却缺少把其中接口级可自动化用例落成可重复执行的脚本,并按统一模板输出报告的路径。本技能针对的是「文档 + 用例 → 跑起来的 API 测试」,而不是写手动用例或压测摸底。
技能如何工作
输入侧:从 OpenAPI 提取接口清单、参数约束、错误码与鉴权方式;从 Schema 筛出 dev-collab 或 automation.framework: api 的用例,环境未知时向用户确认 base URL、账号与是否可写旁路环境,不猜测接口行为。
用例设计侧:按接口做参数矩阵(心内或草稿,不落盘中间文件),覆盖必填/类型/边界、无 Token/越权、同业务键幂等、并发写、错误码触发与响应结构、写后读回一致等;可加载核心 testing-principles 与 data-driven、boundary 方法说明。
脚本与运行侧:默认 pytest + requests(可换项目既定栈);一接口一文件、一点一 test,沿用 TC 编号;敏感信息经环境变量注入;同类边界用 @pytest.mark.parametrize 收敛,断言状态码 + 业务码 + 关键字段;数据自建自清理。失败先区分系统 Bug、环境与用例问题,Bug 证据按 report-template 记录。
适用边界
- Web UI 点击与页面状态 →
automated-e2e-testing - 接口手动用例设计 →
test-case-writing - 压测/限流 → k6/locust 专项
- Mock Server 搭建不在本技能范围内
使用场景
- 拿到新版 Swagger 后,需要在一套旁路环境里跑鉴权与越权用例再提测
- 用例 Schema 里已标 automation.framework: api,要把 TC 编号对接到可执行的 pytest 脚本
- 回归前需对写接口补测幂等与并发写,避免重复创建或中间态覆盖
- 接口返回 200 但业务码失败较多,要统一做状态码+业务码+响应体三件套断言
适合人员
- 负责接口提测前自检的后端/QA,要把 OpenAPI 与自动化用例落成可重复跑的脚本
- 维护微服务契约的团队,需要在各环境用环境变量切换 base URL 与 Token 做回归
- 从手工 Postman 集合迁到 CI 的测试工程师,要对齐 report-template 的执行统计与 Bug 条目
- 接手遗留 API 套件的同学,要按参数矩阵补全错误码与边界而非只断言 200