新版SDK使用说明书
版本1.0 修订时间：2009-10-30
第 1 页 共 9 页
目录
一．Webservice接口 ....................................................................................................................... 3
1.1 webservice返回集合对照表 .............................................................................................. 3 1.2 注册 .................................................................................................................................... 3 1.3 充值 .................................................................................................................................... 4 1.4 balance 查询余额 .............................................................................................................. 4 1.5 mo 接收短信 ................................................................................................................... 5 1.6 msgid 获取msgid .............................................................................................................. 5 1.7 mt 短信发送 ...................................................................................................................... 5 二．Jar包 ......................................................................................................................................... 6
2.1 Client 初始化 ..................................................................................................................... 6 2.2 注册 .................................................................................................................................... 6 2.3 充值 .................................................................................................................................... 7 2.4 getBalance 获取余额 ......................................................................................................... 7 2.5 mt 发送短信 ...................................................................................................................... 7 2.6 mo 接收短信...................................................................................................................... 8 2.7 msgid 获取msgid .............................................................................................................. 8
第 2 页 共 9 页
一．Webservice接口
Webservice地址：http://ip:port /webservice.asmx，详细地址请咨询客户经理
Sn：软件序列号（XXX-XXX-XXX-XXXXX，如SDK-BBX-010-00001）
pwd：加密密码md5(sn+password) ,password是序列号的6位密码
如无特殊说明，参数均为Stirng类型
1.1 webservice返回集合对照表
参数名称 0 1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 说明 成功 保留 帐号/密码不正确 重复登陆 余额不足 数据格式错误 参数有误 权限受限 流量控制错误 扩展码权限错误 内容长度长 数据库错误 序列号状态错误 没有提交增值内容 服务器写文件失败 文件内容base64编码错误 1.2 注册
参数名称 Sn Pwd 说明 软件序列号 密码 第 3 页 共 9 页
备注 格式XXX-XXX-XXX-XXXXX 6位 Province City Trade Entname Linkman Phone Mobile Email Fax Address Postcode Sign
返回值：执行结果（String）
省 市 行业 公司名称 联系人 电话 移动电话 邮件地址 传真 地址 邮政编码 企业签名 必填 必填 必填 必填 必填 必填 必填 必填 必填 必填 必填 (2-15个字符) 1.3 充值
参数名称 Sn pwd cardno cardpwd 返回值：执行结果（String）
说明 软件序列号 密码 充值卡号 充值卡密码 备注 XXX-XXX-XXX-XXXXX 123456 1.4 balance 查询余额
参数名称 Sn Pwd 说明 软件序列号 密码 备注 格式XXX-XXX-XXX-XXXXX md5(sn+password) 函数返回值：String（余额）
示例：序列号SDK-BBX-010-00001 密码 123456
参数输入：
SN= SDK-BBX-010-00001
PWD= 3B5D3C427365F40C1D27682D78BB31E0 参数输出： 103
第 4 页 共 9 页
1.5 mo 接收短信
参数名称 Sn Pwd 说明 软件序列号 密码 备注 格式XXX-XXX-XXX-XXXXX md5(sn+password) 函数返回值：Stirng
返回值说明：mo ID，特服号，手机号，内容（对内容进行gb2312解码），时间，如有多条回车换行隔开
返回示例：
4464020,62891,138****065,ceshi%2fchangsheng,2009-10-1915:51:05 4464023,62891,139****404,test%2fchangsheng,2009-10-19 15:51:17
1.6 msgid 获取msgid
参数名称 Sn Pwd 说明 软件序列号 密码 备注 格式XXX-XXX-XXX-XXXXX md5(sn+password)
函数返回值：String （序列号最近100次发送成功的msgid，以英文逗号隔开） 返回示例：
200910191451432500,200910191302279218,200910191209564687,200910191209009375,200910191200420937
1.7 mt 短信发送
参数名称 Sn Pwd Mobile Content Ext stime Rrid 说明 软件序列号 密码 手机号 内容 扩展码 定时时间 唯一标识 是否必须 是 是 是 是 否 否 否 备注 格式XXX-XXX-XXX-XXXXX md5(sn+password) 必填 双字节70字符 或 单自己140个字节 例如：123（非网络版置空） 例如：2009-10-19 14:45:00（非定时置空） 最长18位 第 5 页 共 9 页
函数返回值：String （唯一标识，即当前发送短信批次的唯一标识,和rrid对应，如为空则返回系统生成的rrid） 示例1：
输入参数：
SN= SDK-BBX-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0 Mobile:139***404,138***213……………. Content:测试
Ext:21（如果不是网络版，请置空）
Stime: 2009-10-19 16:34:00 （如果不需要定时，请置空）
Rrid:123456 （如果填写则系统返回填写内容，如果置空，返回系统生成的rrid） 输出参数：
123456
示例2
SN= SDK-BBX-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0 Mobile:139***404,138***213……………. Content:测试 Ext: Stime: Rrid:
输出参数：
200910191639362343
二．Jar包
2.1 Client 初始化
参数 Sn Pwd 返回值：无
说明 产品序列号 产品密码 备注 例SDK-XXX-010-XXXXX ****** 2.2 注册
参数名称 说明 第 6 页 共 9 页
备注 Province City Trade Entname Linkman Phone Mobile Email Fax Address Postcode
返回值：执行结果（String）
省 市 行业 公司名称 联系人 电话 移动电话 邮件地址 传真 地址 邮政编码 必填 必填 必填 必填 必填 必填 必填 必填 必填 必填 必填 2.3 充值
参数名称 cardno cardpwd
返回值：执行结果（String）
说明 充值卡号 充值卡密码 备注 2.4 getBalance 获取余额
传入参数：无
返回值：余额（String）
2.5 mt 发送短信
参数 Mobile 说明 手机号 内容 扩展码 定时时间 唯一标识 备注 如为多个半角逗号隔开 内容+[签名]=70字 从1开始 格式如：2009-10-30 12:30:30 如果为空，返回系统生成rrid Content Ext Stime Rrid
第 7 页 共 9 页
示例1：
返回值：rrid（唯一标识String）
Mobile:139***404,138***213……………. Content:测试
Ext:21（如果不是网络版，请置空）
Stime: 2009-10-19 16:34:00 （如果不需要定时，请置空）
Rrid:123456 （如果填写则系统返回填写内容，如果置空，返回系统生成的rrid） 输出参数：
123456
示例2：
Mobile:139***404,138***213……………. Content:测试 Ext: Stime: Rrid:
输出参数：
200910191639362343
2.6 mo 接收短信
传入参数：无 返回值： Stirng
返回值说明：mo ID，特服号，手机号，内容（对内容进行URL解码），时间，如有多条回车换行隔开
返回示例：
4464020,62891,138****065,ceshi%2fchangsheng,2009-10-1915:51:05 4464023,62891,139****404,test%2fchangsheng,2009-10-19 15:51:17
2.7 msgid 获取msgid
参数名称 Sn Pwd 说明 软件序列号 密码 备注 格式XXX-XXX-XXX-XXXXX md5(sn+password)
函数返回值：String （序列号最近100次发送成功的msgid，以英文逗号隔开） 返回示例：
第 8 页 共 9 页
200910191451432500,200910191302279218,200910191209564687,200910191209009375,200910191200420937
第 9 页 共 9 页
因篇幅问题不能全部显示，请点此查看更多更全内容