向 API 平台反馈故障，应该保留哪些请求证据

向 API 平台反馈故障，应保留能定位一次请求的时间、平台请求标识、客户端版本和脱敏片段。请求标识缺失时写“未提供”，不要拿本地任务编号冒充平台 ID。本文只整理跨团队定位材料，不列各家错误码的修复大全。

一次请求与一个业务任务分开编号

一个业务任务可能因为应用或 SDK 重试发出多次请求，每次都有不同的时间与平台标识。工单应同时保留本地 job_id、尝试序号和平台返回的标识，并注明标识来源。响应体中的对象 ID 也不一定是故障追踪 ID，不要看到 id 就自动当作同一种东西。

本地任务：demo-job-008（合成编号）
尝试序号：2
开始时间：2026-10-23T10:00:00+08:00
结束时间：2026-10-23T10:00:18+08:00
平台与区域：待填实际值
接口路径：只记录不含秘密的路径
模型请求值：待填
HTTP状态：待填；无响应则写未收到
平台请求标识：待填或未提供
标识位置：响应头 / 异常属性 / 平台控制台
客户端及版本：待填
错误原文：保留嵌套层级，完成脱敏
请求摘要：字段名、类型、合成最小输入
是否重试：记录配置和实际次数

时间包含偏移，耗时使用同一时钟口径；跨机器日志注意时钟偏差，不能只按秒数猜两条记录必然属于同一次请求。

平台标识按各自文档取得

OpenAI 文档介绍响应请求标识及故障定位方式；硅基流动当前接口文档也说明追踪响应头。字段名与行为应按你实际调用的平台核对，不能把某家 SDK 的便利属性当作所有兼容服务的保证。没有 HTTP 响应的网络失败，可能根本没有可读的平台标识。

保留响应头时只摘取必要字段，例如请求标识、状态和相关时间信息；Cookie、认证头与签名地址不进入共享工单。平台要求额外诊断材料时，再按其指定安全渠道提供，不把完整网络抓包直接贴到公开问题区。

最小复现保留结构而替换内容

业务文本替换为合成材料，保持触发问题的长度、空值、消息角色顺序与工具结构。如果替换后不再复现，记录差异，不能声称合成样本已经证明同一问题。请求体过大时提供字段摘要和大小，完整原件留在受限位置。

版本记录包括语言运行时、SDK、代理或网关角色，以及近期是否升级。只写“最新版”会在几周后失去意义，实际版本与时间更有定位价值。多渠道转发时标明链路，但内部域名与凭据仍需脱敏。

发送前做一次可读性复查

让另一位有权限的人按工单理解失败：能否分辨期望与实际，是否知道哪次尝试，能否找到对应附件，是否看得出哪些步骤没做。附件以清单列名称、时间段与脱敏状态，不要把十份没有说明的日志当作证据充分。

本文样例没有真实平台请求记录，不构成服务故障报告。实际发送时只保留你确实观察到的字段，猜测写在单独的待验证栏。

网关链路可以同时有平台标识与网关标识，二者并列保存并注明来源。若只记录最后一层的编号，上游支持人员可能无法查询。最小请求复现成功后，也应保留与原请求在输入大小、参数和链路上的差异，不能直接宣称原故障已经消失。

常见问题

没请求ID是不是不能反馈？ 可以，提供时间、入口、状态与最小复现，并说明ID缺失。

本地UUID能替代平台ID吗？ 只能关联本地日志，平台未必认识它，必须注明来源。

最后一次错误够吗？ 重试场景应保留各次尝试，否则平台可能查不到你描述的那次失败。

继续处理相关问题

相关入口：OpenAI API 接入基础。

官方依据与核对日期

核对日：2026-10-23。OpenAI 请求调试：官方介绍请求标识等调试信息，具体平台字段不能跨服务假定；硅基流动追踪信息：文档说明响应追踪标识可用于问题排查。文中的流程、阈值和合成数据属于工程示例，不能代替当前账号、文件或运行环境的验收。