短信API服务-简易使用教程及注意事项

2020-04-06 行业动态 haoservcie

一、相关注意事项

1.为积极配合运营商治理垃圾短信,按运营商要求,运营商将有投诉记录或回复退订的手机号加入黑名单。如黑名单对您的用户使用有影响,可联系在线客服咨询。

2.[重要] 验证码客户请务必添加图片验证码等防恶意攻击的机制,以防短信轰炸。

3.发送频率:验证码同1个号码同1个签名的内容30秒内只能发2条,1分钟内只能发4条,30分钟内只能发10条,过快的频率可能会导致运营商系统屏蔽,用户无法正常接收

4.短信签名:3到8个字符,应用名称或者公司名称,不能含有特殊字符,如:符号、空格

5.短信内容:不能含有中括号,以及推销电话和链接

6.字数限制:短信内容(包含签名)小于等于70个字符为计费1条。超过70个字符为长短信,按每67个字符计费1条,中英文标点空格都算作一个字符,最多300字符。

二、基本使用流程

1.注册会员

1.1通过http://haoservice.com/注册成为会员,进入个人中心-我的数据,点击申请数据按钮。选择通讯->短信API服务,即可成功申请并获得一定免费次数。

2.申请短信模板

2.1、已经提供了几个常用的模板格式示例供参考,如果开发者还不能满足开发作者实际的需求,您可以自行添加(添加成功后会获得一个模板ID,用于请求API时使用),待审核通过后即可使用自定义模板发送短信,目前短信API服务暂只支持验证码类、通知类信息,不支持营销类,订阅类,邀请类短信都不能发送,涉及关键词也不行,如房产,医疗等的短信内容,如不确定可与我们的在线客服联系确认。

2.2、为什么需要通过模板发送短信?由于运营商对短信内容有一定的监管,会有部分关键字不允许发送。通过模板发送的短信,由于模板提前由专业客服审核,短信内容被屏蔽的可能性非常小。 另外,由于模板已经审核过,使用模板发送不再需要重复做关键字检查,理论上速度会比普通发送的接口更快,非常适合内容相对固定、实时性要求高的触发类短信,如验证码的发送。

2.3、模板变量设置说明:定义一个变量统一格式为:#code#,#号中间的code用户可以自行定义。

3.短信发送API的使用

3.1、接口文档地址:http://www.haoservice.com/docs/17

3.2、根据接口文档格式要求传递数据。个别参数的简易说明:

       建议直接用简易发送方法,系统会自动判断当前账号下有没有审核通过的和发送内容相符合的模板。用户只需要提交短信发送的完整内容即可。

       http://apis.haoservice.com/sms/sendv2?mobile=手机号&

     content=urlencode(【haoservice】您的验证码是123456。如非本人操作,请忽略本短信)&key=apikey

3.3、根据接口文档格式要求传递数据。个别参数的简易说明:

tpl_id:即短信模板的ID,在短信模板中心可以查看。

tpl_value:变量名和变量值对。变量名和变量值对。如果你的变量名或者变量值中带有#&=中的任意一个特殊符号,请先分别进行urlencode编码后再传递。比如您设定了#code# 和 #company#两个变量的模板,示例如下:

参考变量示例:#code#=1234&#company#=好数据

在POST参数时,无特殊字符的代码示例:tpl_value=urlencode("#code#=1234&#company#=haoservice")

带特殊字符的代码示例:tpl_value=urlencode("#code#=1234&#company#=urlencode('好#数#据')")

三、如有任何问题或疑问,请联系在线支持

联系客服

010-58436659