253云通讯变量说明文档

1 变量短信发送
用户通过HTTP的POST方式提交短信发送请求。
1.1 系统提交URL地址
http://sms.253.com/msg/HttpVarSM
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表明提交参数params中格式正确的条数为10条, 发送包失败个数为1表明提交参数msg中格式错误的条数为1条；1234567890100为返回的msgid，这个供状态报告匹配时使用。

1.3.2 提交失败




本示例表明用户提交失败，返回错误码为101，服务器端并未返回msgid。
1.3.3 响应状态值说明
响应的值在1.2.3的基础上增加：
代码 说明
114 可用参数组个数错误（小于最小设定值或者大于1000）;变量参数组大于20个

1.4 示例
http:// sms.253.com/msg/HttpVarSM?account=111111&pswd=123456&msg={$var},你好！，请你于{$var}日参加活动&params=13800210000,李先生,2013-01-01;13500210000,王先生,2013-01-15&needstatus=true