API 响应与错误处理

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

成功与异步受理

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

错误处理

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

动态 IP 的常见业务码见错误码与处理建议；静态住宅的业务码及资金结果见静态 API 概览。具体字段以各接口文章和公开定义为准。