验证码服务API

使用验证码的客户,请务必按 http://www.tui3.com/download/sms.pdf 文档要求,做好安全防范。做好后,提供网址进行审核后方能正常发送。

 

验证码服务是推立方最新推出的服务,本API的特点:

1. 使用高速通道,不需人工审核,及时高效

2. 只能用来发送验证码类服务

一、短信发送

调用地址:
http://www.tui3.com/api/code/?k=发送密钥&r=执行结果格式&t=接收手机号&c=发送的验证码&ti=模板内容索引

参数说明:

k:  32位随机值,由系统自动产生,该值请到产品配置中获取。该值请注意安全保管,勿泄露。
r: 调用后返回的结果格式。json(默认)  xml
t:接收手机列表,多个手机号码请用,分隔(最多支持100个手机号)
c: 发送内容(只能为验证码:数字0-9)
ti: 模板索引(>=1), 见下方模板说明

二、模板说明:

本产品模板只能使用邮件申请,由管理员设置,模板申请请发邮件到:info@tui3.com

本API使用的模板格式为({code}被替换成发送内容):

发送短信内容1{code} 
发送{code}短信内容2

...
发送短信
{code}内容3

 

例如模板:

欢迎您注册本网站,请输入验证码{code},有效期为10分钟
您正在使用本网站恢复密码功能,手机验证码为{code},有效期为10分钟

想发送第一行的内容:

http://www.tui3.com/api/code?k={换成对应的KEY}&t={接收手机号}&c={验证码}&ti=1

想发送第二行的内容:
http://www.tui3.com/api/code?k={换成对应的KEY}&t={接收手机号}&c={验证码}&ti=2


 

返回结果(XML格式,JSON和此相同):

<result>
<err_code>错误代码</err_code>      // 0:正确处理
<err_msg>错误描述</err_msg>       // err_code非0时返回错误描述字符串
<tick_ids>id</tick_ids>    //发送后返回的查询ID。如果为多个手机号,则返回多个id,中间用, 分隔,如果tick_id为-1,则说明该手机号非法,不予发送
<sms_count>处理的短信数量</sms_count> //如果超过一条短信数量,系统将自动拆分进行发送。该值为最后发送的短信数量。
<remain_count>剩余短信数量</remain_count>
</result>
注:因为是异步发送(收到发送请求后立刻返回,由系统其它进程负责发送),所以返回的 sms_count, remain_count 均为估算值,并非精确值。