错误代码
语音接口错误码（平台统一六位码制）与 HTTP 鉴权状态码说明。
业务错误码
语音接口遵循 InnoPaas 平台统一错误码规范（六位数字 PPNNNN）：前两位为错误域，后四位为序号。响应 HTTP 状态码为 200，业务结果通过响应体 code 判断（000000 成功）；参数约束校验失败除外（见下方 HTTP 400）。
平台通用码
| code | 说明 | 语音场景 |
|---|---|---|
| 010002 | 缺少必填参数 | 请求缺少上下文必填字段 |
| 010003 | 参数值不合法 | 字段格式/取值非法、跨字段校验不通过（定时窗时间不合法、非定时携带时间字段、挂机短信字段不完整、destinations 超限、模板国家无映射等） |
| 010005 | 资源不存在或不可访问 | 模板不存在或不属于当前账号 |
| 010006 | 资源状态冲突 | 重复添加（如号码已在白名单） |
| 010012 | 批量数量超限 | 单次被叫超过 1000 |
| 020002 | API Key 无效或失效 | 鉴权未通过 |
| 030001 | 可用余额不足 | 计费预扣失败，请充值后重试 |
| 030002 | 可用授信不足 | 计费预扣失败，请联系管理员 |
| 040001 | API 请求频率超限 | 查询请求过于频繁（发送记录查询 30 QPS） |
| 050001 | 平台内部异常 | 系统繁忙（message 可能带 [gateway] 前缀的网关原始信息） |
| 050002 | 服务暂时不可用 | 服务暂未开放，请稍后重试 |
Voice 专属码（12xxxx）
| code | 说明 | 建议动作 |
|---|---|---|
| 120001 | 测试白名单数量超上限 | 清理测试白名单后重试 |
| 120002 | 号码不在测试白名单 | 将号码加入测试白名单（Console 快速开始流程） |
| 120003 | 号码与模板国家区号不匹配 | 被叫号码须以模板国家的电话区号开头（E.164 格式），参见 国家/地区编码 |
| 120004 | 模板未审核通过 | 使用已通过审核的模板（「模板管理」确认审核状态） |
| 120005 | 国家无可用路由 | 国家/地区暂无可用路由，联系运营开通 |
HTTP 状态码
鉴权与访问控制失败直接返回 HTTP 状态码（无上述响应包络）：
| HTTP 状态码 | 场景 | 说明 |
|---|---|---|
| 400 | 参数约束校验失败 | 字段格式/取值违反约束（如 destinations 为空、messages 超过 1 条、请求体不可解析），返回标准错误体，无 code 包络 |
| 401 | 未携带凭证 | 请求缺少 Authorization 头 |
| 401 | API Key 无效 | API Key 不存在或已删除 |
| 401 | CheckSum 未开放 | 使用 CheckSum 验签方式调用（暂未开放） |
| 403 | API Key 未生效 | 账号、API Key、产品授权任一未处于生效状态 |
| 403 | IP 不在白名单 | 请求出口 IP 不在该 API Key 的白名单内；未配置白名单时拒绝全部请求（多条白名单记录取并集） |
- HTTP 400（字段级约束）与业务码
010003（跨字段/业务规则）是两类失败形态，客户端应同时处理。 - IP 白名单为必配项：未配置即拒绝全部请求；多条白名单记录取并集；变更后最长约 60 秒生效。
最后更新于