Skip to Content
API文档错误码API错误码

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秘钥管理 进行配置