跳到主要内容

API 错误码

调用 USMS 短信服务 API 接口失败时,会返回对应接口错误码。

常见接口错误码、错误提示和处理方案,可参考下述:

错误码错误提示及说明处理措施
18000请求 JSON 解析错误检查请求参数是否有问题
18001请求参数有缺失检查请求参数是否有缺失
18002请求参数格式有误检查请求参数格式是否有误
18003请求参数无效检查请求参数是否有问题
18004、18007API 或服务异常请求未提交成功,请检查参数是否有缺失,或在线咨询
18013当前账号/项目中的短信剩余量不足先检查账号是否有短信余量,若不足,需重新购买;若有余量,请在线咨询处理
18014提交的部分手机号码无效剔除无效手机号码
18016当前账号/项目未申请短信签名或未通过审核需先申请短信签名
18017当前短信模板不存在或未通过审核需先申请短信模板
18018短信模板参数与短信模板不匹配检查模板参数是否有误 或 是否与模板匹配
18019单次提交的手机号码超过 1000 个拦截发送单次提交的手机号码数需在 1000 内
18023短信内容中含有运营商拦截的关键词修改短信内容(一般是短信模板中的变量传值有敏感词)
18033变量内容不符合规范检查模板变量传值是否有误,规范可参考 短信变量
18046代表批量提交任务部分短信提交失败失败详情在返回的 FailContent 字段信息中,客户可基于该信息做相应处理
18048web 发送任务单次提交的号码超过平台上限请确保单次提交的手机号码在平台要求的数量范围内(当前上限 10 万个号码)
18049web 发送任务单次上传的文件超过平台上限请确保单次提交的发送文件在平台要求的文件大小范围内(当前文件大小上限 3M)
151网关缓存服务异常API 网关服务异常,在线咨询处理
160缺少关键参数 Action检查参数是否完整
161Action 不存在检查参数是否完整
170缺失 API 签名请确认 API 请求是否漏填 API 签名信息,可参考 API 调用说明
171API 签名错误检查 API 签名是否有误,可参考 API 调用说明
172账号不存在 This account does not exist确认账号信息是否有误
173账户限制 Account restriction账号受限,可在线咨询,了解详情
174Token 不存在检查参数是否完整
180缺少关键参数 API version检查参数是否完整
200API 公共服务不可用可在线咨询处理
290项目未授权项目未授权,需联系您的主账号管理员将项目授权给您账号
291该账户没有执行对应 Action 和产品类型的权限账号权限不足,需联系您的主账号管理员授权
292项目不存在检查项目信息是否填写有误
294访问 IP 被拒绝客户端 IP 不在 API 白名单中,可在 API 秘钥管理进行配置