​

错误与重试行为

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable explanation",
    "issues": []
  }
}

​

重试指南

• 重试传输层失败。
• 对幂等写入使用相同的 Idempotency-Key 进行重试。
• 异步工作完成后，重新读取持久化状态，而不是假设首次响应已经包含最终结果。

​

实用规则

• 仅当原始写入使用了稳定的幂等键时，才将服务端失败视为可重试的候选。
• 将新的导出下载 URL 视为临时的，需要时从 GET /exports/{exportId} 重新读取。
• 如果某个变更操作已在进行中或与当前状态冲突，请检查返回的 code，仅在该操作在逻辑上仍然安全时才重试。

​

机器可读客户端

• code
• message
• status
• retryable