By name: api-debugger description: 当用户要测试或调试 REST / GraphQL 接口、验证响应格式、对比接口文档与实际行为、生成 Mock 数据时使用。 version: 2.1.0 metadata: zhiwei: tags: - api - rest - graphql - curl - http - testing - mock suggested_tools: - shell_exec - code - file_read - file_write
API 调试指南
curl / Python requests 测试 REST / GraphQL 接口，验证响应格式、对比文档与实际行为。
适用场景
- REST API 请求测试（GET / POST / PUT / DELETE / PATCH）
- GraphQL 查询和变更测试
- 响应格式与状态码分析
- 接口文档对比实际返回（找出文档过期 / 行为异常）
- Mock 数据生成（造测试请求体）
- 批量接口测试（一组端点跑一遍）
不适用场景
- 浏览器端交互测试 → browser-automation
- 代码级单元测试 → code-assistant
- 简单单次 curl → 直接
shell_exec
工作流（按场景分流）
| 场景 | 路径 |
|---|---|
| 单端点测一次 | curl 模板（GET/POST/认证/GraphQL） |
| 验响应格式 | curl + jq / python -m json.tool 看结构 |
| 对比文档 vs 实际 | 调一次 → 跟文档逐字段对，输出差异表 |
| 批量测一组 | 先验单个 → 再 shell 循环或 python requests |
| Mock 数据 | 按 schema 造请求体（用户给字段约束就照填，没给就给典型值） |
各路径要点：
- 同时看状态码 + 响应体：单看 200 不够，body 可能是错误结构（"success":false）
- 敏感信息走变量：Token / API Key 用
$TOKEN/${API_KEY}，不写明文；写入文件时不带 token - 批量先试单个：批量执行前先跑一个验证格式，再 shell 循环或 python 批跑
- 结果落盘：批量测试结果
file_write写api-test-report.md，含端点 / 状态 / 响应摘要 / 差异 -k仅限测试环境：跳 SSL 证书校验只在 dev / staging 用，给用户结果时注明
详细参考
- curl 模板 / 响应分析 / 批量测试 / Mock 生成 / 常见错误：
{skill_dir}/references/curl-recipes.md