Skip to main content
两个 ResQ API 都使用标准 HTTP 状态码,失败时返回简短的 JSON 信封。将状态 码视为权威;响应体是给日志和操作员界面的诊断信息,不要用于流程控制。

信封

Infrastructure API 返回:
Coordination API 返回相同形式,或在报告多个失败的端点上返回更丰富的信封:
始终按 HTTP 状态码分支判断。响应体中的字段名可能演变;状态码是稳定的。

状态码

哪些可以重试

退避草稿

常见错误

401 Unauthorized

重跑认证中描述的登录流程,然后重试请求一次。

403 Forbidden

操作员已认证但缺少所需权限范围。显示给用户;不要重试。任务审批流程要求 HITL 授权操作员(欧盟 AI 法案第 14 条)。

429 Too Many Requests

响应包含 Retry-After 请求头,指示需等待的秒数。至少暂停那么久再重试。

503 Service Unavailable

网状网络或某个上游依赖降级。Coordination API 设计为在此状态下继续运行 —— 遥测摄取在边缘缓存并重试。幂等的客户端请求应带退避重试。

上报错误

如果你遇到此参考无法解释的可重现失败,请在 文档仓库 开 issue,附:
  • HTTP 方法、路径和状态码
  • 如果存在,Request ID(响应头 X-Request-Id)
  • 经过编辑的请求体副本
  • 完整的响应体