错误码说明

OpenAPI v3 响应中的 code 字段是 string。

HTTP 状态码

状态码	说明
200	请求成功（code=success）
400	参数错误、业务校验失败、限流或其他业务错误
401	鉴权失败（如 unauthenticated_request、api_key_disabled）
403	已通过鉴权，但当前 API Key 或账户无权执行该操作（permission_denied）
500	服务器内部错误（service_internal_error）

业务错误码（字符串）

通用错误码

code	说明
success	请求成功
request_too_fast	请求太频繁，请稍后再试
invalid_parameters	参数无效
permission_denied	权限不足
resource_not_found	请求资源不存在
service_busy	服务繁忙，请稍后重试
service_internal_error	服务器内部错误
service_internal_timeout	服务器处理超时
api_deprecated	接口已废弃

OpenAPI v3 常见错误码

code	说明
unauthenticated_request	API 鉴权失败或鉴权头缺失
api_key_disabled	API Key 已禁用
api_key_overdue	当前套餐不包含该项权益
ip_limit	IP 不在白名单中
alternative_order_id_processing	相同备用订单正在处理中
duplicate_alternative_order_id	备用订单 ID 重复
invalid_cert	无效证书
invalid_cert_format	证书格式无效
invalid_organization_info	组织信息无效
invalid_user_info	联系人信息无效
invalid_domain	域名无效
invalid_dcv_method	验证方式无效
order_not_found	未找到订单
dcv_not_completed	域名验证未完成

错误响应示例

{
  "code": "request_too_fast",
  "error": "请求太频繁，请稍后再试"
}

注意

实际返回可能包含未在本页列出的 code（例如新增或细分错误场景）。请以接口实时响应为准。