RCS 错误码
RCS 消息发送受理错误、RCS 专属 150xxx 错误码、HTTP 状态与重试建议。
本页汇总 RCS 消息发送接口的受理错误码。调用成功须同时满足 HTTP 200 和 code=000000；受理结果按 data.messages[] 逐条判断，部分成功时外层 code 仍为 000000，失败条目的 status 为对应六位错误码。
通用错误码
请求失败时根据 HTTP 状态和六位 code 判断原因，保留 traceId 供排查。不要根据 message 文案编写分支；整体失败时 data=null。
| HTTP | code | 含义与处理 |
|---|---|---|
| 400 | 010001 | 请求体 JSON 无法解析，或与声明的 Content-Type 不一致。 |
| 400 | 010002 | 缺少必填字段：productKey、非 TEMPLATE/MMS 消息的 sender、destinations、message.type、destinations[].to、smsFailover 子字段等；按 message 提示补充。 |
| 400 | 010003 | 字段类型、格式、枚举、长度或范围校验失败（手机号格式、消息类型、suggestion 各类校验、productKey 无效等）；按 message 提示修改。 |
| 404 | 010005 | templateId 不存在或不属于当前账户；核对模板 ID 与所属账户。 |
| 400 | 010012 | destinations 条目数超过单次请求上限；按上限拆分请求。 |
| 401 | 020001 | Authorization 与 AppID 均未提供；按接口文档第 2 节提供凭证。 |
| 401 | 020002 | API KEY 不存在、已停用或失效；检查或更换 API KEY。 |
| 403 | 020005 | 出口 IP 不在白名单；API Key 认证模式强制要求白名单，CheckSum 模式仅在已配置时校验。 |
| 401 | 020008 | CheckSum 校验失败，或 Nonce/CurTime/CheckSum 缺失、格式非法；检查 API SECRET、算法与原始签名内容。 |
| 401 | 020009 | CurTime 与服务器时间偏差超过 ±5 分钟；校准时钟后重新生成鉴权信息。 |
| 429 | 040001 | 请求频率超限；降频并遵守 Retry-After 响应头。 |
| 500 | 050001 | 平台内部异常，无法确认是否已受理；保留 traceId 联系支持，勿盲目重发。 |
RCS 专属错误码（150xxx）
150xxx 为 RCS/MMS 产品线专属的受理前校验码段：命中即表示对应条目未受理。详细说明见 150xxx — RCS / MMS；151xxx 为投递结果预留段，本期不使用。
| HTTP | code | 含义与处理 |
|---|---|---|
| 422 | 150001 | 目的地要求模板发送：印尼目的地号码未使用 TEMPLATE 类型；改用模板发送。 |
| 422 | 150002 | 模板变量缺失：按模板补齐 parameters 后重新提交。 |
| 503 | 150003 | 模板未匹配可用通道：稍后重试；持续出现联系支持。 |
| 422 | 150004 | 未关联有效 sender：在控制台完成 sender 配置。 |
| 503 | 150005 | MMS 未匹配可用通道：稍后重试；持续出现联系支持。 |
| 422 | 150006 | 重复内容拦截：营销类消息命中重复相似内容拦截，调整内容后重新提交。 |
| 422 | 150007 | 发送频次拦截：营销类消息命中单 sender 频次拦截，降低频次后重试。 |
| 422 | 150008 | 模板未审核通过：模板审核状态不是"已通过"；使用已审核通过的模板。 |
| 422 | 150009 | 收件人在黑名单：停止向该号码发送，按合规流程处理，不自动重发。 |
最后更新于