模板短信简易接口的业务功能和模板短信接口的业务功能一样,模板短信简易接口主要针对代理商服务,提供简单的http请求接口,直接请求调用即可完成根据短信模板发送短信通知,短信验证码等信息。针对一般的开发者或者企业开发者,建议使用Rest接口,即模板短信接口,其基于https的请求,更加安全,规范。
注意:默认以65个汉字(同65个英文)为一条(可容纳字数受您应用名称占用字符影响),超过长度短信平台将会自动分割为多条发送。分割后的多条短信将按照具体占用条数计费。
? 模板示例如下,其中{数字}为需要接口替换的内容。
【UCPaaS】您的验证码为{1},请于{2}分钟内正确输入验证码
请求地址
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}
响应包体
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
respCode | String | 必选 | 请求状态码,取值000000(成功) |
failure | String | 必选 | 表示短信验证码发送失败的条数。注:批量发送时,才会返回该字段 |
smsId | String | 必选 | 短信标识符。一个由32个字符组成的短信唯一标识符 |
createDate | String | 必选 | 短信的创建时间 |
JSON响应示例
{ "resp": { "respCode": "000000", "failure": 1, "templateSMS": { "createDate": 20140623185016, "smsId": "f96f79240e372587e9284cd580d8f953" } } }