创蓝253云通讯短信平台变量说明

1         变量短信发送

用户通过HTTP的POST方式提交短信发送请求。

1.1      系统提交URL地址

1.2      参数定义

序号	参数	说明
1	account	用户账号
2	pswd	用户密码
3	msg	短信模板。其中的变量用“{$var}”来替代。例如： “{$var},你好！，请你于{$var}日参加活动”，该短信中具有两个变量参数。编码为UTF-8格式。最多支持20个{$var}
4	params	变量短信的参数组。单次提交参数组的数目不能超过1000个。编码为UTF-8格式 每一组参数之间用英文“；”间隔 每一组参数内部用英文“，”间隔，其中第一个参数为手机号码，第二个参数为模板中第一个变量，第三个参数为模板中第二个变量，以此类推。 例如： 13800210000,李先生,2013-01-01;13500210000,王先生，2013-01-15 表明提交了两个变量组，其中手机号码分别为：13800210000和13500210000。模板变量分别为：李先生，2013-01-01和王先生，2013-01-15   格式不符的参数，系统自动过滤掉。
5	needstatus	是否需要状态报告，取值true或false，true，表明需要状态报告；false不需要状态报告
6	extno	可选参数，扩展码，用户定义扩展码，3位,实际提交限制为6位，建议用户扩展3位

 

1.3      提交响应

1.3.1        提交成功

	20110725160412,0,10,1 1234567890100

 

 

 

响应时间为20110725160412，响应状态为0 表明那个成功提交到服务器，参数组个数为10表明提交参数params中格式正确的条数为10条, 发送包失败个数为1表明提交参数msg中格式错误的条数为1条；1234567890100为返回的msgid，这个供状态报告匹配时使用。

 

1.3.2        提交失败

	20110725160412,101

 

 

 

 

本示例表明用户提交失败，返回错误码为101，服务器端并未返回msgid。

1.3.3        响应状态值说明

响应的值在1.2.3的基础上增加：

代码	说明
114	可用参数组个数错误（小于最小设定值或者大于1000）;变量参数组大于20个

 

1.4      示例

?account=111111&pswd=123456&msg={$var},你好！，请你于{$var}日参加活动¶ms=13800210000,李先生,2013-01-01;13500210000,王先生,2013-01-15&needstatus=true