一.注册账号,申请短信API服务
1. 通过www.91cha.com/reg注册成为91查会员,进入个人中心,点击申请服务。选择生活常用->短信API服务,即可成功申请并获得一定免费次数。
二.设置短信模版
1. 91查已经提供了9个常用的默认模板,如果开发者还不能满足实际的需求,可以自行添加(添加成功后会获得一个模板ID,用于请求API时使用),待审核通过后即可使用自定义模板发送短信。
2. 为什么需要通过模板发送短信?由于运营商对短信内容有一定的监管,会有部分关键字不允许发送。通过模板发送的短信,由于模板已提前审核,短信内容被屏蔽的可能性非常小。 另外,由于模板已经审核过,使用模板发送不再需要重复做关键字检查,理论上速度会比普通发送的接口更快,非常适合内容相对固定、实时性要求高的触发类短信,如验证码的发送。
3. 模板变量设置说明:定义一个变量统一格式为:#code#,#号中间的code用户可以自行定义,只能由数字或英文字母表示。
三.短信发送
1. 可根据API文档查看详细调用说明
2. 个别参数说明:
tplid:模版ID,该ID可到后台短信模版处查看
wd:短信内容,变量名和变量值对,如果你的变量名或者变量值中带有#|=中的任意一个特殊符号,请先分别进行urlencode编码后再传递。
参考变量示例:#company#=91查|#code#=1234
参数传递时,无特殊字符的代码示例:wd=urlencode("#company#=91查|#code#=1234")
参数传递时,带特殊字符的代码示例:wd=urlencode("#company#=urlencode('91#查')|#code#=1234")
1. 显示发送成功或失败
请求参数:
名称 |
类型 |
必填 |
说明 |
|---|---|---|---|
key |
string |
是 |
申请接口时获取的key |
tplid |
int |
是 |
短信模版ID,查看模版 |
tel |
string |
是 |
手机号码 |
wd |
string |
是 |
短信内容,该内容得经过urlencode的Utf-8编码,具体教程可查看基本描述里的介绍 比如内容为:#company#=91查|#code#=8888 编码后为:%23company%23%3d91%e6%9f%a5%7c%23code%23%3d8888 |
请求示例:
http://api.91cha.com/sms?key=申请的key&tplid=模版ID&tel=手机号码&wd=短信内容
JSON返回示例:
{
state: 1,
msg: '成功',
data: null
}
错误编号 |
说明 |
|---|---|
102 |
找不到短信模版 |
103 |
参数含有非法字符 |
104 |
发送失败 |
105 |
发送内容超出最大70个字符限制 |
106 |
同一手机号10分钟内重复提交相同的内容 |
107 |
同一手机号一天内超出最大发送次数 |
108 |
手机号码格式有误 |
110 |
模版变量未替换 |
112 |
模版变量内容超过6个字符 |
错误编号 |
说明 |
|---|---|
0 |
查询失败 |
1 |
成功 |
50 |
系统维护 |
51 |
系统异常 |
52 |
key验证失败 |
53 |
未开通该服务 |
54 |
未找到开通的套餐 |
55 |
包月套餐已超过今日使用量 |
56 |
按次套餐已使用完 |
57 |
服务参数有误 |
58 |
套餐已用完或者扣费异常 |
59 |
包月套餐已到期 |
60 |
请求IP验证不通过 |
等级 |
资费 |
说明 |
|---|---|---|
体验用户 |
0.00 元 |
10 次/天 |
等级 |
资费 |
说明 |
|---|---|---|
LV1 |
500.00 元 |
10000 次 |