AIGoCode API 排错日志怎么整理：先脱敏，再对照状态码

先把排错材料分成三类

准备排查 AIGoCode API 时，先把材料分成请求示例、错误响应和运行环境三类。这样做的目的不是把整份日志丢给别人，而是让对方能复现问题的结构，同时看不到不该共享的认证信息。可以从 AIGoCode Tools 首页进入对应工具。

第一份材料保留请求方法、接口路径、状态码和脱敏后的请求体；第二份只保留必要的错误文本；第三份记录使用的客户端或脚本，以及发生时间。不要把真实 API Key、Authorization 头或包含密钥的环境文件放进共享材料。

第一步：用敏感信息脱敏工具处理日志

Tools 页面提供“敏感信息脱敏”，原文说明是：“分享配置和日志前，遮盖其中的密钥与敏感信息。”页面同时标注“本地处理 · 脱敏预览”。因此可以先把准备分享的日志复制到工具中，检查预览结果，再把脱敏后的文本用于工单或团队讨论。

脱敏后手动扫一遍：Key 的前缀是否还剩下过多字符、Cookie 和 Authorization 是否已移除、请求体里是否混入邮箱或内部路径。工具能帮助遮盖敏感内容，但你仍要确认上下文没有通过文件名、URL 查询参数或错误堆栈泄露。

第二步：用 HTTP 状态码对照表确定排查方向

同一首页还提供“HTTP 状态码对照表”，页面原文写明：“查询常见 HTTP 状态码的中文解释、原因和处理建议。”界面标签为“1xx–5xx · 搜索 · 复制 开始使用 →”。把实际返回的状态码单独记下来，再用对照表查含义，排错讨论就能从“连接失败”变成明确的 HTTP 分支。

这一步只负责整理状态码含义，不代表工具已经检查了你的账号、额度或服务端。真正的 API 结论仍应以请求返回的状态码、响应体和当前配置为准。

第三步：需要复现时把 curl 转成代码

如果同事给你一条可复现的 curl 命令，Tools 页面还提供“curl 转代码”，原文说明是：“把 curl 命令转换为 Python、JavaScript 和 Go 请求代码。”界面标签为“请求头 · 请求体 · Basic Auth 开始使用 →”。先确认命令中没有真实 Key，再选择团队实际使用的语言生成代码，便于逐字段检查。

生成代码后，不要直接在共享仓库提交包含认证值的版本。把 Key 改成环境变量占位符，只保留方法、地址、请求头名称和请求体结构。这样既能比较不同客户端的请求差异，也能避免把凭据带进示例。

最后保存一份可复查记录

可以用下面的模板整理一次排错：

这套流程的边界很清楚：AIGoCode Tools 负责本地整理、查询和转换，AIGoCode API 的认证、协议与服务状态仍要回到实际请求和官方文档核对。先把材料整理干净，再提交问题，通常比直接上传整份日志更容易定位。