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