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