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}日参加活动¶ms=13800210000,李先生,2013-01-01;13500210000,王先生,2013-01-15&needstatus=true