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 分钟；校准时钟后重新生成鉴权信息。 |
最后更新于