跳转到主要内容
对于每个生成用量记录的模型请求,ApiGo 都会在响应头中返回 x-apigo-request-id。这个 ID 用于关联响应与 ApiGo 中的对应请求记录。 当响应包含该 header 时,请将它与你自己的请求数据和日志一起保存。后续可以使用这个 ID 查找对应的用量记录,或协助 ApiGo 支持团队定位问题。

读取请求 ID

请求 ID 位于 HTTP 响应头中:
HTTP/1.1 200 OK
content-type: application/json
x-apigo-request-id: 2012345678901234567
建议同时记录以下信息:
  • 你的业务请求 ID
  • x-apigo-request-id
  • 请求时间和 endpoint
  • HTTP 状态码

流式请求

流式请求会在数据流开始之前发送 HTTP 响应头。如果响应包含 x-apigo-request-id,请在读取 SSE 事件时保留这个值,并将它与整条数据流关联。

使用建议

  • 将请求 ID 作为不透明字符串保存。不要将它转换为 JavaScript Number
  • 不要解析请求 ID、根据其格式编写逻辑,或自行生成这个值。
  • 不要使用请求 ID 判断调用成功或失败。请使用 HTTP 状态码和响应内容。
  • 如果需要联系支持团队,请同时提供请求 ID、请求时间、endpoint 和 HTTP 状态码。
在 ApiGo 创建用量记录之前被拒绝的请求不适用上述保证,包括部分网关级错误和早期校验错误。客户端不应将缺少请求 ID 本身视为新的请求错误。