短信错误码

短信受理前校验（100xxx）与受理后投递结果（101xxx）错误码、相邻通用码与存量编码说明。

本页汇总短信接口使用的平台错误码。所有业务码均为六位数字字符串，000000 表示本次接口操作成功。短信发送受理成功仅表示平台已接收，不代表消息已经送达；最终投递结果请从查询接口或回调数据获取。

本页按评审规范的 SMS 章节编排：100xxx 用于提交校验，101xxx 用于投递结果。请按完整六位码判断；前缀只用于目录分类，不能据此推断重试策略或受理状态。

码段说明

码段	领域	说明
`010xxx`	请求与资源	参数、格式、资源状态与幂等冲突。
`020xxx`	身份与访问	API Key、权限、IP、账户与鉴权。
`030xxx`	计费与额度	余额、授信、周期额度与计费配置。
`040xxx`	频率与并发	请求速率、提交速率与并发限制。
`050xxx`	平台服务	平台内部异常与未知请求结果。
`100xxx`	短信提交校验	受理前校验失败；修正请求或账户配置后重新提交。
`101xxx`	短信投递结果	受理后的逐条结果；从查询结果或回调数据读取。
`06xxx`–`09xxx`	通用预留	统一申请后分配。
`90xxx`–`99xxx`	暂不分配	保留扩展。

通用错误码

短信接口也可能返回通用码。完整清单和处理方式请查看对应码段：

遇到 429 或临时 503 时，有 Retry-After 就至少等待该时长；否则使用有上限的指数退避。原请求结果未确认前，不要创建新的短信发送请求。

提交校验（100xxx）

100xxx 表示本次请求未受理。请修正原因后重新提交。

错误码	名称	客户处理方式	是否重试
`100001`	发送方未登记	完成发送方登记。	修复后提交
`100002`	模板不可用于发送	使用已审核通过且可用的模板。	修复后提交
`100003`	发送方式不支持	使用受支持的发送方或发送方式。	修复后提交
`100004`	内容不符合要求	按公开规则修改内容。	修复后提交
`100005`	发送方未授权	使用已授权的发送方。	修复后提交
`100006`	目的地未开放	检查目的地范围或申请开通。	修复后提交
`100007`	内容与模板不匹配	按已审核模板生成内容。	修复后提交
`100008`	短信分段数超限	缩短内容或调整字符集。	修复后提交
`100009`	收件人已退订	停止相应发送，并按合规流程处理授权。	不自动重发
`100010`	不在允许发送时间内	等待允许时段，并检查消息有效期。	等待后重试
`100011`	暂无可用短信路由	稍后重试；持续出现时联系支持。	等待后重试

号码或发送方格式错误使用 010003；格式合法但发送方未登记使用 100001。响应没有明确说明时，不要推断为内容违规。

投递结果（101xxx）

101xxx 描述已受理消息的投递结果，出现在查询结果或回调数据中，不作为发送请求的 HTTP 错误码。

错误码	名称	客户处理方式	是否重试
`101001`	接收号码无效	核对号码并更新数据。	不自动重发
`101002`	接收方暂时不可达	按业务有效期决定是否后续发送。	不自动重发
`101003`	运营商拒绝接收	查看目的地要求，必要时联系支持。	不自动重发
`101004`	有效期内未确认送达	标记结果未知，不能认定必然未收到。	不自动重发
`101005`	内容被下游拦截	检查内容与目的地要求。	不自动重发
`101006`	发送方被下游拒绝	检查登记与适用范围。	不自动重发
`101007`	下游容量限制	调整后续发送速率，评估是否创建新消息。	不自动重发
`101008`	下游网络故障	关注恢复情况，并按业务决定是否后续发送。	不自动重发
`101009`	接收方拒收	停止相应发送并记录拒收。	不自动重发
`101010`	消息到期未发送	检查有效期、排队与发送量。	不自动重发
`101011`	平台执行失败	保留消息 ID 和 traceId，联系支持。	不自动重发
`101012`	投递失败原因未知	保留消息 ID，联系支持。	不自动重发

101004 表示投递结果未知；101012 表示明确失败但原因未知。再次发送属于新的业务操作，可能产生另一笔费用。

处理原则

000000 表示接口操作成功；对发送接口而言，仅表示请求已受理。
查询成功时仍可能查到失败消息：外层 code 保持 000000，失败原因位于 data.errorCode。
命中 100xxx 时，先修正请求或账户配置，再重新提交。
命中 101xxx 时，不要自动重发；根据业务有效期和投递结果决定后续动作。
遇到未文档化的错误码时，记录 code、message 和 traceId，停止自动重试并联系支持。

相关文档

最后更新于