注册 登录

侧边栏

文档首页

常见问题

SDK下载

返回码

短信API

用户工具

您在这里: 接入建议 » 模板短信简易接口
模板短信简易接口

这是本文档旧的修订版！

目录

模板短信简易接口

模板短信简易接口的业务功能和模板短信接口的业务功能一样，模板短信简易接口主要针对代理商服务，提供简单的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 必选 短信接收端手机号码集合，用英文逗号分开，每批发送的手机号数量不得超过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"
		}
	}
}

页面工具