发布时间 : 星期三 文章短信门户webservice接口协议标准版更新完毕开始阅读
浙江电信短信门户webservice接口协议
2009-7-28
1.短信门户接口协议结构
短信门户webservice接口如下图1所示:
客户端 上下行 短信消息包 服务端 短信 接口协议 TCP/IP 物理连接 TCP/IP 物理连接 1 图
2.短信门户接口地址:
接口地址:http://122.224.69.42:8181/axis/SendAndGetMessage.jws
3.接口方法:
接口主要方法:发送短信(sendMessage)和接收短信(getMessages) 3.1发送短信方法sendMessage(String username,String pwd,String messages),无返回值。
参数说明:
Username:企业主叫(企业开户时的主叫号码) pwd:企业帐号在短信门户后台数据库的密码
messages:短信包。短信包中的每条下行短信用“/r/n/”分隔(例
如:短信1/r/n/短信2/r/n/短信3/r/n/),每条下行短信
包括3个组成部分,分别为:短信接收方号码,发送模式(取值为1或2,1表示用企业主叫号码发送,2用短信门户平台的轮换号码发送),发送内容,每个部分用“/%/$/”分隔(例如:13357181569/%/$/1/%/$/短信测试)。每个短信包可以放30到50条短信。下
行短信包与下行短信的结构图见图2,图3所示。
下行短信包结构图如下: 短信1 /r/n/ 短信2 /r/n/ ----------------------> 下行短信包发送顺序
图2
下行短信结构图如下: 接收号码 /%/$/ 发送模式 /%/$/ ----------------------> 下行短信发送顺序
图3
短信3 /r/n/ …… 发送内容 3.2 接收短信方法getMessages(String username,String pwd ),返回值为字符串。 参数说明:
Username:企业主叫(企业开户时的主叫号码) pwd:企业帐号在短信门户后台数据库的密码
返回值为上行短信消息包,上行短信消息包中的每条上行短信用“/r/n/”分隔(例如:短信1/r/n/短信2/r/n/短信3/r/n/),每条上行短信包括3个组成部分,分别为:短信发送方号码,
发送内容,发送时间,每个部分用“/%/$/”分隔(例如:057185303873/%/$/短信测试/%/$/20090728121212)。上行短信
包与上行短信的结构图见图4,图5所示。
上行短信包结构图如下: 短信1 /r/n/ 短信2 /r/n/ ----------------------> 上行短信包发送顺序
图4
上行短信结构图如下: 发送方号码 /%/$/ 短信内容 /%/$/ ----------------------> 上行短信发送顺序
图5
短信3 /r/n/ …… 接收时间