# API 响应与错误处理

区分 HTTP 状态、数字业务码、请求 ID 与异步受理结果，并按功能查找错误详情。

公开 API 使用账户级 [API 令牌](/developers/authentication/api-token)或接口明确说明的认证方式。读取响应时先看 HTTP 状态，再看 JSON 中的数字业务 `code` 和 `message`；`requestId` 用于排障，不等同于业务幂等编号。

## 成功与异步受理

静态 API 成功响应包含 `code: 200`、`message`、`requestId` 和 `data`。采购、续费的 HTTP `202` 只表示任务已受理，需查询订单或操作的最终状态；改密的 HTTP `200` 仍需检查逐项结果。动态 IP 提取的返回格式见[提取返回格式](/developers/api/response-formats)。

## 错误处理

参数、令牌、实名或权限问题应先修正，不要自动重试。HTTP `401` 表示认证失败，`403` 表示资格或权限拒绝，`429` 遵循 `Retry-After`；临时 `500/503` 应有限退避。部分白名单操作的业务码 `10431` 需要读取 `failed_items`，只处理失败项。静态写入结果不确定时使用原 `clientOrderNo` 或 `clientOperationNo` 找回，不能换编号盲目提交。

动态 IP 的常见业务码见[错误码与处理建议](/developers/errors/error-codes)；静态住宅的业务码及资金结果见[静态 API 概览](/developers/api/static-supply)。具体字段以各接口文章和公开定义为准。