跳到正文
本中心目录
API 文档 · 接入说明

API 响应与错误处理

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

只只HTTP技术团队维护更新于 2026年9月29日

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

成功与异步受理

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

错误处理

参数或认证问题应先修正。读取失败可有限退避;写入结果不确定时使用原 clientOrderNo 或 clientOperationNo 回查,不能换编号盲目重复交易。所有错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。动态部分成功与各接口返回格式见对应接口的成功响应。

这篇内容解决了你的问题吗?

反馈只用于改进公开文档,不会提交账号或请求信息。