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个
原文地址:http://blog.51cto.com/13567544/2154673