常见的返回码

返回码(code)

错误信息(msg)

具体错误描述或解决方法(detail)

问题
处理人

0

OK

调用成功,该值为null

无需处理

1

请求参数缺失

补充必须传入的参数

开发者

2

请求参数格式错误

按提示修改参数值的格式

开发者

3

账户余额不足

账户需要充值,请充值后重试

开发者

5

未自动匹配到合适的模板

未自动匹配到合适的模板

开发者

6

添加模板失败

模板有一定的规范,按失败提示修改

开发者

7

模板不可用

审核状态的模板和审核未通过的模板不可用

开发者

10

手机号防骚扰名单过滤

手机号在防骚扰名单表中

开发者

11

用户号码防骚扰

超级短信下发手机号在用户后台超级短信退订号码管理列表中

开发者

14

解码失败

请确认内容编码是否设置正确

开发者

15

签名不匹配

短信签名与预设的固定签名不匹配

开发者

16

签名格式不正确

短信内容不能包含多个签名【 】符号

开发者

18

签名校验失败

签名校验失败

开发者

20

暂不支持的国家地区

暂不支持的国家地区

开发者

23

号码归属地不在模板可发送的地区内

号码归属地不在模板可发送的地区内

开发者

25

手机号和内容个数不匹配

手机号和内容个数不匹配

开发者

34

签名创建失败

检查签名是否合法或者已经创建过了

开发者

38

修改签名失败

报备中/审核成功的签名不支持修改,详细信息参考detail返回的内容

开发者

48

参数长度超过限制

超级短信创建模板返回的报错,详细信息参考detail返回的内容

开发者

50

模板不支持的运营商

超级短信下发手机号所属运营商的模板不可用

开发者

53

手机号接收超过频率限制(文本、语音、超级短信)

手机号接收超过频率限制,详情联系客服(文本、语音、超级短信)

客服

55

服务已下线

停用该服务

开发者

56

手机号码格式不正确

请确认号码格式(国际号码过长或过短等原因)

开发者

-1

非法的apikey

apikey不正确或没有授权

开发者

-2

API没有权限

用户没有对应的API权限

开发者

-3

IP没有权限

访问IP不在白名单之内,
可在后台系统设置->IP白名单里添加该IP

开发者

-4

访问次数超限

超过设置的单日消耗限制

开发者

-5

访问频率超限

接口查询频率超限

开发者

-6

不支持批量发送

该接口不支持批量发送

开发者

-11

用户未开启该功能

账户未开启该功能,请在用户控制台开启

开发者

-50

未知异常

客户端或服务器出现未知的异常情况,可参考-50未知异常文档排查原因及获得解决方案

开发者/技术支持

-51

系统繁忙

系统繁忙,请稍后重试

技术支持

-55

记录不存在

没有找到预期中的数据

开发者

-57

无可用签名

无可用签名

开发者

-58

手机号定制短链接失败

手机号定制短链接失败

技术支持

-62

无效资质信息

开发者信息未完善,请在后台“账户设置”中完善开发者信息,审核通过后可调用此API

开发者