掌中宝-HTTP通信接口规范.doc

文档介绍：掌中宝—HTTP通信接口规范

最新修改时间:2008-01
一、工作方式 1
二、字符编码 1
三、响应格式 2
四、短信发送 2
五、取剩余短信条数 3
六、程序示例 3
最新文档下载地址:.
测试账号
用户名:10086 密码:10010
一、工作方式
采用HTTP 方式,使用POST方法传递参数。
另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名和密码的方式。
二、字符编码
GB2312编码
三、响应格式
所为响应即每次向服务器提交请求后返回值
响应值格式为纯文本
状态码
如发送成功后返回
,ID=任务编号,例:50,ID=632
四、短信发送
采用HTTP 方式,使用POST方法传递参数。 POST方式,不支持GET方式
接口发送演示 http://10086./
接口参数说明:
参数名
参数字段
参数说明
Username
用户账号
汉字、数字、字母均可
Password
用户密码
不可用系统默认密码,请自行登陆http://10086.
修改密码
自行登陆http://10086.
SmsType
短信类型
1商信通 5企信通
encode
字符编码
可选项,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数 encode=utf8
mobiles
接收号码
同时发送给多个号码时,号码之间用英文半角逗号分隔(,)如:**********,**********,**********
分包量
流量
POST 方式
分包量每500--1000条号码,少量会影响系统
流量每500--1000条号码,少量会影响系统
Message
短信内容
发送内容需要进行URL字符标准化转码。
{URL字符编码说明:返回字符串,此字符串中除了-(%)后跟两位十六进制数,空格则编码为加号(+)
请到网站发送页面查询或咨询业务人员(数字英文均算一个字)
发送结果
返回ID
正整数为成功提交的条数,ID=任务编号,例:50,ID=632
返回发送的状态码
状态码说明
数量+ID号成功提交的条数,ID=任务编号,例:50,ID=632
-20 不可以用默认密码进行查询和发送
-21 密码或用户名不可用或没有权限
-22 短信类型(SmsType)不正确
-30 余额为0
-31 内容中含有禁发词XXX
-34 内容超长
-35 余额不足
六、取剩余短信条数
URL:http://10086./SmsPort/
参数名
参数字段
参数说明
Username
用户账号
汉字、数字、字母均可
Password
用户密码
不可用