信封
Infrastructure API 返回:始终按 HTTP 状态码分支判断。响应体中的字段名可能演变;状态码是稳定的。
状态码
哪些可以重试
退避草稿
常见错误
401 Unauthorized
403 Forbidden
429 Too Many Requests
响应包含 Retry-After 请求头,指示需等待的秒数。至少暂停那么久再重试。
503 Service Unavailable
网状网络或某个上游依赖降级。Coordination API 设计为在此状态下继续运行 ——
遥测摄取在边缘缓存并重试。幂等的客户端请求应带退避重试。
上报错误
如果你遇到此参考无法解释的可重现失败,请在 文档仓库 开 issue,附:- HTTP 方法、路径和状态码
- 如果存在,Request ID(响应头
X-Request-Id) - 经过编辑的请求体副本
- 完整的响应体