三、应报文
开发帮助文档
返回报文统一使用Json数据格式,编码为utf-8
1、公共报文格式
以账号认证失败为例
{
"code": "1005",
"msg": "账号鉴权失败",
"detail": "核对账号及认证信息"
}
2、常见返回码
| 返回码 | 错误信息 | 详细说明 |
|---|---|---|
| 0 | SUCCESS | |
| 1001 | 账号被关闭 | |
| 1002 | 短信字数过长 | |
| 1003 | 单次发送号码过多 | |
| 1004 | Http请求方式错误 | |
| 1005 | 账号鉴权失败 | |
| 1006 | IP鉴权失败 | 发送短信的帐号绑定了IP |
| 1007 | 余额不足 | |
| 1008 | 错误的手机号码 | |
| 1009 | 手机黑名单过滤 | |
| 1010 | 签名无效 | |
| 1011 | 签名格式不正确 | |
| 1012 | 请求参数缺失 | |
| 1013 | 敏感词屏蔽 | |
| 1014 | 未找到对应id模板 | |
| 1015 | 对应id模板不可用 | |
| 1016 | 存在多个签名 | |
| 1017 | 签名黑名单 | |
| 1018 | 找不到通道(未知的手机号段可能导致此问题) | |
| 1019 | 模板变量值包含域名后缀 | |
| 1022 | 同一个手机号码在单位时间内超过发送次数 | |
| 1090 | 系统内部错误 | |
| 1091 | ||
| 1092 | 系统内部错误 | |
| 201 | 创建新实体 | |
| 202 | 服务器接收请求,处理尚未完成 | |
| 204 | 服务器正常响应,但响应实体为空 | |
| 301 | 请求资源的地方发送永久变动 | |
| 302 | 请求资源的地址发生临时变动 | |
| 304 | 客户端缓存资源依然有效 | |
| 400 | 请求信息出现语法错误 | |
| 401 | 请求资源无法授权给未验证用户 | |
| 403 | 请求资源未授权当前用户 | |
| 404 | 请求资源不存在 | |
| 405 | 请求方法不匹配 | |
| 406 | 请求资源的媒体类型不匹配 | |
| 500 | 服务器内部错误 | |
| 501 | 服务器不支持当前请求 |