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;问题持续时联系支持人员。400001、400009和明确的业务错误通常需要先修正条件,立即重复相同请求没有意义。