API Debugging Toolkit（接口调试工具）
知识库位置：
FDE Knowledge Base/11 Tools/04-Engineering/01-API-Debugging-Toolkit.md
Step 1 — Capture Request（捕获请求）
Section titled “Step 1 — Capture Request（捕获请求）”记录：
Timestamp（时间戳）Endpoint（端点）Method（HTTP 方法）Request ID（请求标识）Headers（请求头）Payload shape（载荷结构）Environment（环境）注意避免记录敏感 Secret（密钥）。
Step 2 — Classify Failure（失败分类）
Section titled “Step 2 — Classify Failure（失败分类）”Network（网络）TLS（传输层安全）Authentication（认证）Authorization（授权）Validation（校验）Rate Limit（限流）5xx（服务端错误）Timeout（超时）Application Logic（应用逻辑）Status Code Shortcut（状态码速查）
Section titled “Status Code Shortcut（状态码速查）”400→ Request invalid（请求无效）
401→ Authentication（认证失败）
403→ Authorization（授权失败）
404→ Resource / endpoint（资源/端点不存在）
409→ Conflict（冲突）
429→ Rate limit（限流）
5xx→ Server / dependency（服务端/依赖故障）Step 3 — Compare Known-good Request（对比已知良好请求）
Section titled “Step 3 — Compare Known-good Request（对比已知良好请求）”对比：
Working（正常请求）vsFailing（失败请求）看：
- Token（令牌）
- Headers（请求头）
- Payload（载荷）
- Environment（环境）
- User（用户）
- Endpoint（端点）
Step 4 — Check Timing（检查耗时）
Section titled “Step 4 — Check Timing（检查耗时）”记录：
DNS（域名解析）Connect（建连）TLS（安全握手）Server（服务端处理）Total（总耗时）如果 Total（总耗时）慢，不代表 API Server（接口服务）本身慢。
Step 5 — Retryability（可重试性）
Section titled “Step 5 — Retryability（可重试性）”分类：
Retryable（可重试）Non-retryable（不可重试）Unknown（未知）Debug Output（调试输出）
Section titled “Debug Output（调试输出）”Observed（观察到的现象）:Evidence（证据）:Likely Layer（可能的层）:Hypothesis（假设）:Test（验证）:Result（结果）:Fix（修复）: