网店管家 3.0 手机短信接口规范
一.概述
“网店管家”3.0版本提供了三种短信发送方式,一种是利用短信猫等硬件设备完成短信的收
发,另外一种是利用官方的短信平台发送短信,还有一种就是根据接口规范开发自己的短信接口。该文档对“短信通讯接口”做了说明。
二原理
“网店管家”应用端生成短信,经过“管家助理”处理后加入发送队列,并递交接口发送。
为了简便起见,采用http的get方法递交数据。
三.接口
客户端发起请求,服务器端验证并响应。接口地址为形如:http://www.xxxx.com/yyyy的URL地址。消息如下:
1. 账户验证:
参数:
Msg |
消息(smsAU) |
User |
用户名 |
PWD |
密码 |
返回:
例:http://www.xxxx.com/yyyy?Msg=smsAU&User=aaaa&PWD=bbbb
2. 短信发送:
参数:
Msg |
消息(smsSnd) |
User |
用户名 |
PWD |
密码 |
Tel |
手机号码(多条短信用半角逗号隔开) |
Body |
内容 |
返回:
0 |
账户无效 |
1 |
发送成功 |
2 |
余额不足 |
3 |
接口故障 |
注:先验证账户的有效性,查询是否余额充足,然后发送。
3. 余额查询:smsBalance
参数:
Msg |
消息(smsBalance) |
User |
用户名 |
PWD |
密码 |
返回:金额值
注:所有参数均采用UTF8编码
四.部署
对于参数“用户名(user)”、“密码(pwd)”根据需要做验证或者不验证,但是必须对“账户验
证((smsAU))”消息做相应,否则会导致无法激活队列任务。根据上面的接口开发好程序后,在管家助理中做相应配置,如图:
------该帖子于2011-12-2 13:29:46被作者编辑过------