统一错误码
更新时间：2026-07-17 15:03:49
公共响应
| 状态码 | 描述 | 说明 |
|---|---|---|
| 120001 | signature verification failed | 验签失败 |
| 120301 | request header is missing AppID or incorrect | AppID 缺失 / 未绑定产品 |
| 120302 | missing parameters in message header | 消息头参数缺失 |
| 120401 | invalid token | 无效 Token |
| 120504 | signature expired | 签名过期（CurTime 与服务器时间差 > 5 分钟） |
| 190004 | invalid parameter | 参数错误 |
| 190403 | forbidden | IP 白名单校验失败 |
| 190500 | Internal Server Error | 服务器未捕获异常 |
| 201500 | 未知错误 | 默认业务异常 |
| 201501 | 参数类型错误 | 参数类型错误 |
| 201502 | 请求解析错误 | 请求解析错误 |
| 201503 | 账号不存在 | 账号不存在 |
| 201504 | 子账号不存在 | 子账号不存在 |
| 201505 | 子账号无权限 | 子账号无权限 |
| 201506 | 参数为空 | 参数为空 |
| 201507 | 参数错误 | 参数错误 |
| 201602 | productType参数为空 | productType 为空 |
| 201603 | productType参数不合法 | productType 不合法 |
| 201655 | 无权限操作 | 无权限操作 |
| 201656 | 查询列表最大长度为100 | 查询列表最大长度为 100 |
| 201658 | 图片上传失败 | 图片上传失败 |
| 201661 | 查询列表长度超限 | 查询列表长度超限 |
国内短信-短信发送接口
成功状态码
| 状态码 | 描述 | 说明 |
|---|---|---|
| 000000 | success | 请求成功 |
认证状态码（120开头）
| 状态码 | 描述 | 说明 |
|---|---|---|
| 120001 | signature verification failed | 验签失败，CheckSum校验不通过 |
| 120301 | request header is missing AppID or incorrect | AppID缺失或不存在，AppId未绑定产品类型 |
| 120302 | missing parameters in message header | 消息头参数缺失，鉴权参数不完整，CurTime格式错误 |
| 120401 | invalid token | 无效Token，账号信息不存在或AppSecret不存在 |
| 120504 | signature expired | 签名过期，CurTime与服务器时间差超过5分钟 |
通用状态码（190开头）
| 状态码 | 描述 | 说明 |
|---|---|---|
| 190004 | invalid parameter | 参数错误（详见下方业务状态码细分） |
| 190403 | forbidden | IP白名单校验失败，没有权限 |
| 190500 | Internal Server Error | 服务器端出现未捕获异常 |
业务状态码（201开头）
| 状态码 | 描述 | 说明 |
|---|---|---|
| 201100 | 请求uri错误 | - |
| 201101 | 无此用户 | 账号不存在或账号状态异常 |
| 201102 | 密码错误 | 密码校验失败 |
| 201103 | 提交请求太快 | - |
| 201104 | 系统忙 | - |
| 201105 | 含有敏感危险词 | - |
| 201106 | 消息长度错(>1036或<=0) | 消息长度>1036或<=0 |
| 201107 | 手机号码格式错误 | 手机号格式不合法 |
| 201108 | 手机号码个数错误 | - |
| 201109 | 余额不足 | - |
| 201110 | 不在发送时间内 | - |
| 201111 | 超出该账户当月发送额度限制 | - |
| 201112 | 产品错误 | - |
| 201113 | 扩展码格式错误 | 扩展码仅支持数字，且长度受限 |
| 201114 | 可用参数组错误 | - |
| 201116 | 签名错误 | - |
| 201117 | 客户端IP错误 | - |
| 201118 | 该用户无权限 | 账号发送状态被限制 |
| 201119 | 用户已经过期 | 账号已过有效期 |
| 201120 | 违反防盗策略, 超过日发送限制 | - |
| 201121 | 必填参数,是否需要状态报告 | - |
| 201122 | 5分钟内相同账号提交相同消息内容过多 | - |
| 201123 | 发送类型错误 | 账号不支持HTTP发送 |
| 201124 | 白模板匹配错误 | - |
| 201125 | 匹配到驳回模板 | - |
| 201126 | 匹配审核通过模板错误 | - |
| 201127 | 定时发送时间格式不正确 | - |
| 201128 | 内容编码失败 | - |
| 201129 | JSON格式错误 | - |
| 201130 | 请求参数错误 | 通用参数校验失败 |
| 201131 | 相同手机号码，相同内容在指定的时间内发送次数限制 | - |
| 201132 | 消息长度错(>3500或<=0) | - |
| 201133 | 单一手机号错误 | - |
| 201134 | 违反防盗策略, 超过月发送限制 | - |
| 201135 | 超过同一手机号相同内容发送限制 | - |
| 201136 | 不可批量提交”验证码”短信 | - |
| 201137 | 请求唯一性验证失败 | - |
| 201138 | 短信发送时间戳参数错误 | - |
| 201139 | 超出安全发送时间 | - |
| 201140 | 短信内容解密错误 | - |
| 201141 | 指定域名错误 | - |
| 201142 | 该行业短信内容已被驳回 | - |
| 201143 | 电话号码发送数量大于反投诉数 | - |
| 201144 | 产品未上线限制日发送数量 | - |
| 201145 | 验签失败 | - |
| 201146 | 电话号码发送数量大于分钟反投诉数 | - |
| 201147 | 电话号码发送数量大于小时反投诉数 | - |
| 201148 | 电话号码发送数量大于日反投诉数 | - |
| 201149 | 电话号码发送数量大于周反投诉数 | - |
| 201150 | 电话号码都在黑名单 | - |
| 201151 | 模板不匹配 | - |
| 201152 | 模板不存在 | - |
| 201153 | 暂不支持模板短信 | - |
| 201154 | 消息长度错(>3500或<=0) | - |
| 201155 | 转发失败 | - |
| 201156 | 智慧消息余额不足 | - |
| 201157 | 转发开关未开启 | - |
| 201158 | 发送内容中退订语不符合运营商要求 | - |
| 201159 | 触发反轰炸策略 | - |
| 201165 | 引流未报备(未知链接) | - |
业务参数校验错误明细（190004）
以下错误统一返回 Code: 190004，通过 Msg 字段区分具体原因：
| Msg 内容 | 说明 |
|---|---|
| templateId 不能为空 | 未传模板ID |
| templateId{xxx}不存在 | 模板ID未找到对应模板 |
| phoneNumbers 不能为空 | 未传手机号 |
| 签名传参{xxx} 与模板关联签名 {yyy} 不相同 | 传入签名与模板绑定签名不一致 |
| 最多支持1000个手机号 | 手机号数量超限 |
| templateParamJson 解析异常 | 变量参数JSON格式错误 |
| templateParamJson 解析无数据 | 变量参数为空 |
| phoneNumbers与templateParamJson 数量不匹配 | 手机号与变量参数数量不一致 |
| 该模板不支持变量参数 | 非变量模板传了变量参数 |
| 变量模板未传递变量参数 | 变量模板未传变量参数 |
| uid 长度不应超过256 | 外部请求ID超长 |
| report请传 true 或 false | Report参数值不合法 |
| 扩展码仅支持X位内数字 | 扩展码格式不合法 |
| 所有手机号或参数均不合法 | 全部手机号或参数校验失败 |
国内短信-资质管理
| 状态码 | 描述 |
|---|---|
| 201604 | 终端资质id为空 |
| 201605 | 终端资质id必须为纯数字字符串 |
| 201626 | 终端资质id不在当前主体下 |
| 201627 | 经办人信息身份证照片与姓名不符 |
| 201628 | 经办人信息身份证照片与身份证不符 |
| 201639 | 终端资质id不能为空 |
国内短信-签名管理
| 状态码 | 描述 |
|---|---|
| 201606 | 签名id为空 |
| 201607 | 签名id必须为纯数字字符串 |
| 201630 | 签名内容数据为空或不合法 |
| 201631 | 签名长度为2-20个字符 |
| 201632 | 签名类型数值传递错误 |
| 201662 | 签名类型参数异常 |
| 201633 | 应用场景数值传递错误，只能传为自己或者为他人 |
| 201653 | 至少选择一项应用场景 |
| 201652 | 选择修改应用场景时，历史签名不能编辑 |
| 201643 | 签名名称不能包含中文括号，必须使用英文括号 |
| 201634 | app_url为必传字段 |
| 201629 | 审核通过签名不允许删除 |
| 201637 | 当前签名已存在 |
| 201636 | 签名个数达到上限 |
| 201657 | 签名列表超流速 |
| 201610 | 请上传经办人授权书 |
| 201622 | 签名实名参数错误 |
| 201654 | 签名实名参数异常 |
| 201651 | 编辑签名实名信息类型不能为空 |
| 201613 | 经办人信息与公司法人信息不符,请重新提交 |
| 201615 | 请上传法人身份证人像面 |
| 201616 | 请上传法人身份证国徽面 |
| 201617 | 请上传经办人身份证人像面 |
| 201618 | 请上传经办人身份证国徽面 |
| 201623 | 请输入正确的手机号 |
| 201624 | 经办人身份证号仅支持数字和大写字母 |
| 201625 | 统一社会信用代码仅支持数字和大写字母 |
| 201635 | 开启审核提醒的情况下，接收手机号必填 |
| 201614 | 备注长度超过上限,最大支持%s个字符 |
| 201611 | 应用场景为他人时,需要传营业执照 |
| 201619 | 签名使用方为他人时，合同首页不能为空 |
| 201620 | 签名使用方为他人时，业务/合同有效期页不能为空 |
| 201621 | 签名使用方为他人时，合同尾页不能为空 |
| 201640 | 签名场景为自己时，终端资质只能为自己 |
| 201641 | 签名场景为他人时，终端资质只能为他人 |
| 201642 | 补充材料不能超过9张 |
| 201644 | 至少需要上传一张图片，或者图片数据为空 |
| 201645 | 场景为他人时，图片数量不合法 |
| 201646 | 签名选择企业名称时，只允许信用代码为9开头的公司申请 |
| 201647 | ICP备案单位与终端客户名称不一致，无法提交 |
| 201648 | 商标已失效，可联系客服/对应商务补充材料解决 |
| 201649 | 商标注册人与所选终端客户名称不一致无法提交，请上传商标授权书/许可备案截图 |
| 201612 | 图片大小不能超过2M |
| 201638 | 文件上传失败 |
国内短信-模板管理
| 状态码 | 描述 |
|---|---|
| 201608 | 模板id为空 |
| 201609 | 模板id必须为纯数字字符串 |
| 201650 | id参数错误或id对应数据已删除 |
| 201659 | 模板不支持编辑 |
| 201660 | 模板列表查询超流速 |
这篇文档对您有帮助吗？
