用户工具

模板短信简易接口

这是本文档旧的修订版!


模板短信简易接口

模板短信简易接口的业务功能和模板短信接口的业务功能一样,模板短信简易接口主要针对代理商服务,提供简单的http请求接口,直接请求调用即可完成根据短信模板发送短信通知,短信验证码等信息。针对一般的开发者或者企业开发者,建议使用Rest接口,即模板短信接口,其基于https的请求,更加安全,规范。

短信验证码(快速接入)

注意:默认以65个汉字(同65个英文)为一条(可容纳字数受您应用名称占用字符影响),超过长度短信平台将会自动分割为多条发送。分割后的多条短信将按照具体占用条数计费。

? 模板示例如下,其中{数字}为需要接口替换的内容。

【UCPaaS】您注册{1}网站的验证码为{2},请于{3}分钟内正确输入验证码

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 必选 短信接收端手机号码集合,用英文逗号分开,每批发送的手机号数量不得超过100个(国内短信不要加前缀,国际短信号码前须带相应的国家区号,如日本:0081)
param String 必选 内容数据,用于替换模板中{数字},若有多个替换内容,用英文逗号隔开即可

请求示例

get http://www.ucpaas.com/maap/sms/code?sid=#{sid}&appId=#{appId}&time=#{time}&sign=#{sign}&to=#{to}&templateId=#{templateId}&param=#{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"
		}
	}
}

页面工具