SDK使用说明
- 格式:doc
- 大小:134.50 KB
- 文档页数:8
SDK使用说明书(简版)
版本1.0 修订时间2010-06-12
一.WEBSERVICE接口 (1)
1.1 WEBSERVICE返回集合对照表 (1)
1.2注册(R EGISTER) (2)
1.3充值(C HARG U P) (2)
1.4查询余额(BALANCE) (3)
1.5接收短信(MO) (3)
1.6接收短信(MO2) (3)
1.7获取MSGID (4)
1.8短信发送(MT) (4)
1.9 REPORT 获取短信回执 (5)
2.0个性发送(GXMT) (6)
二.发送说明(必看) (6)
三.接收说明 (7)
四.其它说明 (7)
五.开发建议 (7)
一.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返回集合对照表
1.2 注册(Register)
返回值:执行结果(String)
序列号第一次使用一定要注册否则不能执行别的操作如发送短信,查询余额等1.3 充值(ChargUp)
返回值:执行结果(String)
Cardno 和Cardpwd 由相应的商务提供
1.4查询余额(balance)
函数返回值:String(余额)
示例:序列号SDK-BBX-010-00001 密码123456
参数输入:
SN= SDK-BBX-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
参数输出:
103
1.5接收短信(mo)
函数返回值:Stirng
返回值说明:mo ID,特服号,手机号,内容(对内容进行gb2312解码),时间,如有多条回车换行隔开
返回示例:
4464020,62891,138****065,ceshi%2fchangsheng,2009-10-19 15:51:05 4464023,62891,139****404,test%2fchangsheng,2009-10-19 15:51:17每条记录是一行多条记录中间是以回车换行隔开
如返回1表示暂时没有用户回复信息
1.6接收短信(mo2)
函数返回值:String
返回值说明:mo ID,特服号,手机号,内容(对内容进行gb2312解码),时间,如有多条
回车换行隔开
返回示例:
4464020,62891,138****065,ceshi%2fchangsheng,2009-10-19 15:51:05 4464023,62891,139****404,test%2fchangsheng,2009-10-19 15:51:17每条记录是一行多条记录中间是以回车换行隔开
mo和mo2的区别
调用mo是将此时间段内所有的回复短信全部接收,同时平台数据清除变为已收状态再次接收不会有数据;
调用mo2每次调用记录当前最大id 如1234 此时间段内调用会返回大于1234的数据不会删除当前一批信息,如果没有保存好信息可以重复接收
如返回1表示暂时没有用户回复信息
1.7获取msgid
函数返回值:String (序列号最近100次发送成功的msgid,以英文逗号隔开)
返回示例:
200910191451432500,200910191302279218,200910191209564687,20 0910191209009375,200910191200420937
1.8 短信发送(mt)
函数返回值: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
1.9 report 获取短信回执
函数返回值:String
返回值说明:ID,特服号,手机号,唯一标识,状态,时间
状态值说明:接收成功:移动,C网,电信返回DELIVRD联通返回0
接收失败:其他值
每次最多返回999条,每条用回车换行隔开。
如为第一次使用,maxid=1
返回示例:
1127835,62891,159*404,200910191209564687,DELIVRD,2009-10-19 13:01:36
1127865,62891,189*404,200910191200420937,DELIVRD,2009-10-19 13:01:42
1127866,62891,132*404,200910191209009375,0,2009-10-19 13:01:42 1128003,62891,139*404,200910191302279218,DELIVRD,2009-10-19 13:03:05
如果返回0 表示此时没有返回报告返回如果返回-7 表示您没有查看返回报告的权限需要申请开通
2.0 个性发送(gxmt)
函数返回值:String (唯一标识,即当前发送短信批次的唯一标识,和rrid对应,如为空则返回系统生成的rrid)
1、手机号以英文逗号隔开
2、发送内容GB2312编码后,以英文逗号隔开,个数和手机号个数一致
3、扩展码可以为空,单个,或多个(以英文逗号隔开,个数和手机号个数一致)
4、定时时间可以为空,单个,或多个(以英文逗号隔开,个数和手机号个数一致)二.发送说明(必看)
●做单发(每次提交只有一个手机号)时,相同内容不得超过20次.
如果需要发送大量的单条信息并且内容不相同,请参考gxmt的方法;
●做群发(提交内容相同)时,请参看mt 的使用方法,禁止连续一条一条的提
交.
●字符说明,接口所有方法都是gb2312编码,使用时请进行相应转换
●长短信说明:
SendSMS,SendSMSEx,SendSMSEx_R,SendSMS_R,mdSmsend,mt 一次提交内容最大是600字节300汉字(建议290汉字) 此时出现长短信的概念.
●长短信扣费说明:
如果一次提交小于等于70字符系统会默认为一条短信发出扣费一条
如果大于70字符系统会默认为长短信处理此时根据长短信前边会加(1/2) 或者(2/2)的标志此时扣费按65字符扣一条所以198字符是65*3+3 扣费4条对方如果手机支持长短信则收到一条如果不支持长短信则收到四条(建议内容不超过290)
●禁止相同的内容多个手机号一条一条提交.
三.接收说明
●接收短信间隔最少为5秒;
●接收短信每条以回车换行符分割,接收内容请进行url解码; 四.其它说明
●Linux,UNIX操作系统使用webservice接口;
●开发使用的帐号必须为SDK开头,如SDK-OFT-010-00001,帐号第一次需
要调用Register方法注册一次;;
●UnRegister与Register配合使用,连续使用不得超过10次/天;
●开发过程需要开发语言的Demo 请联系相应人员;
五.开发建议
●群发推荐使用接口方法mt或者mdSmsSend (仅方法名不同);
●单发(多个手机号需连续提交但内容不同)推荐gxmt;
●在程序里最好有配置文件,程序自动判断当某个接口连接超时提交速度变
慢时.程序可以自动切换其它的接口以下是推荐的几个服务器,仅接口地址不同而已.方法全部相同;
地址1:http://211.157.113.148:8060/webservice.asmx
地址2:http://211.157.113.56:8060/webservice.asmx
地址3::8060/webservice.asmx
地址4:/webservice.asmx
●禁止相同的内容多个手机号连续一条一条提交.。