错误码
平台通用错误码
| 错误码 | 含义 | 常见原因 | 排查建议 |
|---|---|---|---|
000000 |
请求成功 | 接口调用正常 | 无需处理 |
400001 |
参数校验异常 | 缺少必填项、参数类型或格式错误、取值超出范围 | 对照 API 文档逐项核对参数名称、类型和取值范围 |
400002 |
用户校验失败 | AppID/AppKey 错误、签名失效、无接口权限、密钥已重置、账号未完成实名认证 | 检查凭证、时间戳、签名算法、接口权限和认证状态 |
400003 |
请求数据转换异常 | Body 不是合法 JSON、字段嵌套错误、编码格式不一致 | 使用 UTF-8 编码和 application/json，校验 JSON 格式是否合法 |
400004 |
系统异常 | 服务临时故障或后台处理失败 | 记录请求 ID，间隔后有限重试；仍失败则联系技术支持 |
400005 |
系统超时 | 网络延迟、服务处理过慢、并发过高 | 增加合理超时时间、降低并发、配置指数退避重试 |
400006 |
请求 IP 不合法 | 出口 IP 未加入白名单或不在允许范围内 | 确认真实出口 IP，在账号安全中心申请加入白名单 |
400007 |
获取真实请求 IP 失败 | 代理层未透传真实 IP、请求头缺失 | 检查代理或网关配置，确保 X-Forwarded-For 等头正确透传 |
400008 |
业务异常 | 业务逻辑校验未通过，具体原因以响应 message 为准 | 查看响应中的业务错误码和提示信息，对照 API 文档处理 |
400009 |
Redis 异常 | 平台缓存服务故障 | 平台端问题，记录请求 ID 后联系技术支持 |
400010 |
账号已被禁用 | 账号因违规、欠费或其他原因被平台禁用 | 联系商务或技术支持确认账号状态及解禁流程 |
400011 |
接口剩余条数不足于本次调用 | 已购买套餐的剩余调用次数不够本次请求消耗 | 前往「数据中心 / 我的 API」购买补充套餐 |
400012 |
SQL 语法错误 | 平台内部数据库查询异常 | 平台端问题，记录请求 ID 后联系技术支持 |
400013 |
数据库异常 | 平台数据库服务故障或连接异常 | 平台端问题，记录请求 ID 后联系技术支持 |
400014 |
下游接口返回为空 | 第三方数据源无返回数据或返回格式异常 | 确认请求参数是否正确，重试后仍为空则联系技术支持 |
400015 |
接口调用次数限制 | 触发接口的总调用次数上限或套餐额度上限 | 查看剩余额度，额度不足时购买补充套餐 |
400016 |
API 余额记录为空 | 账号未购买该 API 套餐，或余额记录异常 | 确认是否已申请并购买该 API，未购买请先购买套餐 |
400017 |
API 接口不存在 | 请求的 API ID 或路径错误、接口已下线 | 核对 API 详情页中的接口地址和 API ID 是否正确 |
400018 |
API 接口被禁用 | 该接口已被平台下架或临时停用 | 联系商务确认接口状态，或更换其他可用接口 |
400019 |
请求过于频繁，超过 QPS 限制 | 单位时间内请求数超过接口允许的 QPS 上限 | 降低请求频率，增加请求间隔，或联系商务申请提升 QPS |
400020 |
服务暂不可用，请稍后再试 | 平台服务维护、升级或临时不可用 | 稍后重试，持续不可用则关注平台公告或联系技术支持 |
400021 |
预扣次数计算失败，预扣字段配置有误 | 平台端接口计费字段配置异常 | 平台端问题，记录请求 ID 后联系技术支持 |
400022 |
您还未购买此 API 接口 | 账号仅申请了权限但未购买套餐，或购买未生效 | 前往「数据中心 / 我的 API」购买对应套餐 |
400023 |
接口剩余的日调用条数不足于本次调用 | 当日调用次数已达日限额 | 次日再试，或联系商务申请提升日调用额度 |
400024 |
接口状态异常 | 接口处于维护、灰度或异常状态 | 稍后重试，持续异常则联系技术支持确认接口状态 |
400025 |
预扣费异常 | 平台端预扣费流程异常 | 平台端问题，记录请求 ID 后联系技术支持核查是否重复扣费 |
400026 |
扣费异常 | 平台端实际扣费流程异常 | 平台端问题，记录请求 ID 后联系技术支持核查扣费记录 |
400027 |
连接超时异常 | 与下游服务建立连接超时，网络不通或服务不可达 | 检查网络连通性，增加连接超时时间，重试后仍失败联系支持 |
400028 |
读取超时异常 | 连接已建立，但下游服务响应超时 | 增加读取超时时间，降低并发，确认下游服务是否正常 |
400029 |
没有匹配的记录 | 查询条件无对应数据，或请求的资源不存在 | 核对查询参数是否正确，确认数据是否已入库 |
以上为平台接口通用错误码，各 API 的专属业务错误码在该 API 的详情页查看。
联系技术支持时提供
遇到问题请联系对应商务人员，或由客服对接技术人员直接与我方技术支持沟通排查。联系时请准备以下信息：
- API 名称和 API ID。
- 发生时间和时区。
- 脱敏后的请求参数、HTTP 状态和错误码。
- 服务端出口 IP。
requestId或调用明细编号。- 是否在线测试成功、是否仅个别时段失败。
禁止向技术支持发送 AppKey、完整身份证号、手机号、业务密文或其他不必要的敏感数据。