OpenAPI 接口文档
OpenAPI 接口文档

错误码

由 Open API 正常生成的业务错误响应返回 HTTP 200。调用方应依据响应体 code 选择是否修正参数、查询结果或稍后重新发起安全的只读请求。传输层故障可能没有本页所列的 JSON 错误码,处理方式见响应结构

code 对外含义 常见场景 建议处理
0 成功 请求成功 处理 data
300001 数据不存在 账号、订单、资源不存在或不可访问;地区上级不可用 核对编号和归属,不要反复重试
300006 重复请求 24 小时内重复使用同一 request_no 不要重提;通过已有列表、详情或资源状态核对,响应不会重放第一次结果
300184 钱包余额不足 购买或续费所需余额不足 补充余额后使用新的请求号重新操作
300320 资源价格不存在或与请求规格不匹配。
300323 地区不可用 静态代理库存、购买报价或购买订单使用的地区当前不可购买,或凭据地区不可使用 重新查询地区并选择其他值
300324 库存查询失败 库存查询、购买报价或购买订单未能取得实时库存 稍后重新查询;持续失败时联系支持人员
300325 库存不足 购买报价或购买订单的数量超过当前库存 降低数量或稍后重新查询库存
300328 动态子账号已移除 对已移除账号执行变更 改用其他账号
300340 动态流量余额非正 创建动态子账号的前置条件不满足 先购买动态流量
300341 动态子账号达到上限 无法继续创建账号 复用现有账号或联系支持人员
300358 子账号名称已存在 名称已经被当前账号使用 更换 sub_account 和请求号
400001 认证失败 API Key 缺失、无效或不可用 检查 Key 和环境,不要盲目重试
400009 请求参数错误 字段缺失、格式错误、未知字段或不支持的方法 修正请求后重试
500000 系统处理失败 请求未完成,具体原因未公开 不要假定再次请求可以解决;创建请求先查询结果

处理原则

  • 创建请求遇到超时或 500000 时,不要使用原 request_no 或新 request_no 盲目重提;先按请求号与重复提交核对结果。
  • 500000 不说明问题会持续多久,也不保证重复请求能够成功。保存 X-TRACE-ID;问题持续时联系支持人员。
  • 400001400009 和明确的业务错误通常需要先修正条件,立即重复相同请求没有意义。

On this page