SuperAPI AI 工具集

rest-graphql-debug

测试与质量

查看项目

更新于 10-16 02:32

技能介绍

用途:系统化诊断 REST 与 GraphQL API 故障,先隔离失败层再修复,避免凭猜测改代码。适用于状态码或响应体异常、401/403 认证失败、Postman 可用但代码失败、Webhook 回调调试、集成测试编写、限流与分页问题。不适用于 UI 渲染、数据库查询调优、DNS/防火墙等基础设施问题。

主要能力:按连通性、超时、TLS/SSL、认证、请求格式、响应解析、语义七层顺序排查;提供 HTTP 状态码手册(401、403、404、409、422、429、5xx)的检查清单;处理 GraphQL 常见陷阱(HTTP 200 仍可能含 errors 字段);支持分页(offset 与 cursor)、幂等键、契约校验、关联 ID 捕获与回归测试模板。

使用方式:通过 Hermes 工具执行。terminal 用于 curl、dig、openssl,例如 terminal('curl -v https://api.example.com/users/1');execute_code 用于多步 Python 流程,例如 requests.get(url, timeout=(3.05, 30));web_extract 拉取厂商文档;delegate_task 做完整 CRUD 测试扫描。GraphQL 请求示例:curl -X POST https://api.example.com/graphql -H 'Content-Type: application/json' -H "Authorization: Bearer $TOKEN" -d '{"query":"{ user(id: 1) { name email } }"}'。回归测试可用 terminal('pytest tests/test_api_smoke.py -v') 运行。

限制与安全:requests 无默认超时,必须显式传 tuple 超时;-k 仅限临时调试,不可写入代码;令牌不得硬编码或完整记录日志,应从环境变量读取,泄露后立即轮换;避免在 URL 查询串中放 API 密钥。资料未提供具体收费、平台支持范围与效果数据。