======模板短信简易接口======
模板短信简易接口的业务功能和模板短信接口的业务功能一样,模板短信简易接口主要针对代理商服务,提供简单的http请求接口,直接请求调用即可完成根据短信模板发送短信通知,短信验证码等信息。针对一般的开发者或者企业开发者,建议使用Rest接口,即模板短信接口,其基于https的请求,更加安全,规范。
===== 短信验证码(快速接入) =====
注意:默认以65个汉字(同65个英文)为一条(可容纳字数受您应用名称占用字符影响),超过长度短信平台将会自动分割为多条发送。分割后的多条短信将按照具体占用条数计费。
? 模板示例如下,其中{数字}为需要接口替换的内容。
【UCPaaS】您的验证码为{1},请于{2}分钟内正确输入验证码
==== 1.1 请求 ====
**请求地址**
get或post http://www.ucpaas.com/maap/sms/code
**请求包体**
^属性 ^类型 ^约束 ^说明 |
|sid |String |必选 |主账户id|
|appId |String |必选 |应用Id|
|sign |String |必选 |验证信息,使用MD5加密(账户id+时间戳+账户授权令牌),共32位(小写)|
|time |String |必选 |时间戳yyyyMMddHHmmssSSS,有效时间为30分钟|
|templateId |String |必选 |模板Id|
|to |String |必选 |短信接收端手机号码(国内短信不要加前缀,国际短信号码前须带相应的国家区号,如日本:0081)|
|param |String |必选 |内容数据,用于替换模板中{数字},若有多个替换内容,用英文逗号隔开即可|
**请求示例**
get http://www.ucpaas.com/maap/sms/code?sid=#{sid}&appId=#{appId}&time=#{time}&sign=#{sign}&to=#{to}&templateId=#{templateId}¶m=#{param}
post
http://www.ucpaas.com/maap/sms/code
sid=#{sid}
appId=#{appId}
time=#{time}
sign=#{sign}
to=#{to}
templateId=#{templateId}
param=#{param}
==== 1.2 响应 ====
**响应包体**
^属性 ^类型 ^约束 ^说明 |
|respCode |String |必选 |请求状态码,取值000000(成功)|
|failure |String |必选 |表示短信验证码发送失败的条数。注:批量发送时,才会返回该字段|
|smsId |String |必选 |短信标识符。一个由32个字符组成的短信唯一标识符|
|createDate |String |必选 |短信的创建时间|
**JSON响应示例**
{
"resp": {
"respCode": "000000",
"failure": 1,
"templateSMS": {
"createDate": 20140623185016,
"smsId": "f96f79240e372587e9284cd580d8f953"
}
}
}