请求参数(Headers)
请求参数(Query)
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
mobile | STRING | 必选 | 手机号 |
paras | STRING | 必选 | 模板参数。多个参数用逗号分隔,需要urlencode |
sign | STRING | 可选 | 签名。需要urlencode。自定义签名,请联系客服 |
tpid | STRING | 必选 | 模板ID |
请求参数(Body)
正常返回示例
{ "result": 0, "errmsg": "OK", "ext": "", "sid": "8:AALpiIOLJ5EtyyJV9wu20180416", "fee": 1}
- 1
- 2
- 3
- 4
- 5
- 6
失败返回示例
{ "result": -1, "errmsg": "paras format error, mobile or tpid is NULL"}
- 1
- 2
- 3
错误码定义
错误码 | 错误信息 | 描述 |
---|---|---|
-1 | 参数错误 | 客户端参数错误 |
-2 | 短信长度超过70个字 | |
1014 | 模版未审批或请求的内容与审核通过的模版内容不匹配 | |
1016 | 手机号格式错误 | |
1017 | 请求的短信内容太长 | |
1021 | 请求发起时间不正常,通常是由于您的服务器时间与云大师服务器时间差异超过 10 分钟导致的 | |
1022 | 业务短信日下发条数超过设定的上限 | |
1023 | 单个手机号 30 秒内下发短信条数超过设定的上限 | |
1024 | 单个手机号 1 小时内下发短信条数超过设定的上限 | |
1025 | 单个手机号日下发短信条数超过设定的上限 | |
1026 | 单个手机号下发相同内容超过设定的上限 | |
1029 | 营销短信发送时间限制 | 为避免骚扰用户,营销短信只允许在 8 点到 22 点发送 |
1004 | 请求包解析失败,通常情况下是由于没有遵守 API 接口说明规范导致的 | 服务器错误 |
1008 | 请求下发短信/语音超时 | 出现概率很低,可重试解决 |
1013 | 下发短信/语音命中了频率限制策略 | |
1015 | 手机号在黑名单库中,通常是用户退订或者命中运营商黑名单导致的 |