常见的返回码

返回码(code)

错误信息(msg)

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

问题
处理人

0

OK

调用成功,该值为null

无需处理

1

请求参数缺失

补充必须传入的参数

开发者

2

请求参数格式错误

按提示修改参数值的格式

开发者

3

账户余额不足

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

开发者

5

未自动匹配到合适的模板

未自动匹配到合适的模板

开发者

6

添加模板失败

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

开发者

7

模板不可用

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

开发者

10

手机号防骚扰名单过滤

手机号在防骚扰名单表中

开发者

14

解码失败

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

开发者

15

签名不匹配

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

开发者

16

签名格式不正确

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

开发者

17

24小时内同一手机号发送次数超过限制

24小时内同一手机号发送次数不能超过5次

开发者

18

签名校验失败

签名校验失败

开发者

20

暂不支持的国家地区

暂不支持的国家地区

开发者

23

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

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

开发者

25

手机号和内容个数不匹配

手机号和内容个数不匹配

开发者

33

同一个手机号同一验证码模板每30秒只能发送一条

同一个手机号同一验证码模板每30秒只能发送一条

开发者

34

签名创建失败

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

开发者

38

修改签名失败

审核成功的签名不能被修改

开发者

43

一天内同一手机号
发送次数超过限制

发送失败,今天该号码
可接收的语音验证码超过限制

开发者

53

手机号接收超过频率限制

手机号接收超过频率限制,详情联系客服

客服

55

服务已下线

停用该服务

开发者

-1

非法的apikey

apikey不正确或没有授权

开发者

-2

API没有权限

用户没有对应的API权限

开发者

-3

IP没有权限

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

开发者

-4

访问次数超限

超过设置的单日消耗限制

开发者

-5

访问频率超限

接口查询频率超限

开发者

-6

不支持批量发送

该接口不支持批量发送

开发者

-11

用户未开启该功能

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

开发者

-50

未知异常

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

开发者/技术支持

-51

系统繁忙

系统繁忙,请稍后重试

技术支持

-55

记录不存在

没有找到预期中的数据

开发者

-57

无可用签名

无可用签名

开发者

-58

手机号定制短链接失败

手机号定制短链接失败

技术支持