处理错误与不确定结果

同时检查 HTTP 状态和 JSON 响应。AntAPI 使用 code、data、error 信封。成功时 code 为 0、error 为空字符串，data 为接口对应的业务数据。失败时返回稳定的非零错误码和可读错误信息，不应根据翻译后的错误文本编写判断逻辑。

以下仅展示信封结构，不是完整产品响应：

{
  "code": 0,
  "data": {},
  "error": ""
}

具体接口的字段与错误以生成的 API Reference 为准。HTTP 202 代表异步操作已受理。HTTP 200 的结果页仍可能包含失败或结论不明的条目，需要检查每项字段。

选择恢复方式

HTTP 状态	检查内容	处理方式
400	请求结构、输入或参数。	修正输入后再尝试。
401	凭据缺失、无效、被撤销或项目不可用。	检查 Key 及 Organization、Project 状态。
402	适用 Credits 或资金预留要求。	检查余额与本操作最高费用。
404	已发布路径或当前项目范围内的资源标识。	核对路径、任务 ID 和项目。
409	同键输入改变，或原操作仍在处理。	阅读错误内容，重试原请求时保留原 Key。
429	请求频率或并发限制。	降低并发并退避；如有 Retry-After 则遵循。
502	上游连接或响应安全检查失败。	执行结果可能不确定，保留原操作身份。
503	发布快照或结算暂时不可用。	退避后重试同一次逻辑操作。
504	上游超时。	不要假设尚未执行，使用原 Key 或 Job ID 恢复。

具体产品错误可能比此 Gateway 概览更详细。来源可用性和单项结果语义以产品指南为准；无法确定的结果不属于成功处理项。

执行结果不确定时

创建批次超时、尚未取得 Job ID 时，使用已保存的 Idempotency-Key、原请求体和查询参数重试同一个 POST。如果已有 Job ID，调用进度与结果接口；这些读取不会新建批次或增加查询扣费。

同步调用使用稳定幂等键时，可以保持已记录资金结果一致，但不保证重新返回原业务正文。不要为恢复丢失正文而静默创建新的付费操作。

平台在恢复已授权执行时保留原预留。客户端断开和 HTTP 超时都不会取消工作。取消批次会停止后续工作，已成功项仍可能参与结算。

收集有效诊断信息

记录 HTTP 状态、稳定错误码、X-Request-ID、时间以及可用的批次 Job ID，并核对 Console 中对应的用量与 Receipt。分享诊断信息前，移除 Authorization 请求头、API Key、Cookie、请求体和敏感结果。