请求 ID 说明
请求 ID(Request ID) 是每一次 API 调用生成的唯一标识符。无论请求成功与否,系统都会生成该 ID,用于全链路追踪和问题定位。
格式示例
请求 ID 通常由字母和数字组成,可能包含特定前缀:
- 示例 A:
chatcmpl-e21ecc93a6bd4e95854d2490cdef7dc5 - 示例 B:
msg_e21ecc93a6bd4e95854d2490cdef7dc5
请求 ID 的作用
- 故障排查:遇到 API 调用错误或异常时,请求 ID 是定位问题的关键线索。
- 技术支持:联系技术支持时提供请求 ID,可便于快速定位本次请求,高效解决问题。
- 日志审计:用于在自身系统中关联和记录 API 调用情况。
如何获取请求 ID
可以通过以下两种方式获取本次调用的请求 ID:
- 方式一:通过响应头。在 HTTP 响应头中查找字段
Http_x_reqid。 - 方式二:通过响应体。无论调用返回成功还是失败,响应体的 JSON 数据中均包含请求 ID 字段。
信息
建议在异常处理逻辑中始终记录返回的请求 ID,便于后续排查。

