用商务领航行的webservice发送短信

 作者：梅劲松
本文档和程序为MIT授权

 

因为需要方便发送短信，所以寻找能通过webservice发送商务领航短信的接口程序，发现竟然没有。简单调试了下，贡献给大家吧。

 

一、python程序，其中使用了pyton 2.7、pyxml、soappy。

# -*- coding: cp936 -*-
import SOAPpy,string

class MyPyWebService:

    def __init__(self):
        self.server = SOAPpy.WSDL.Proxy("http://58.53.194.80/swdx/services/APService?wsdl")
     
    def GetResult(self):
       return self.server.sendMessage('xxxxx','xxxxx','xxx','xxx','13986288','',msg.decode('cp936') )

if __name__ == "__main__":
    msg='天气晴朗，阳光明媚，多么适合打劫啊，走,同去打劫吧！'
    print MyPyWebService().GetResult()

 

二、相关资料如下：

1、发送短信接口说明

A.     接口定义

1)       验证版本号

【接口原型】：sendMessage ();

【接口路径】：http://58.53.194.80/swdx/services/APService?wsdl

【功能说明】：发送接口

【参数说明】：

参数名称	数据类型	说明
ApName	String	SP帐号
ApPassword	String	SP密码
compcode	String	企业标识
userCode	String	用户帐号
calledNumber	String	被叫号码
sendTime	String	发送时间
content	String	发送内容

时间格式：2008-04-24 15:33:09  如果为空则是即时发送

calledNumberError	被叫号码错误
calledNumberNull	被叫号码为空
sendTimeError	发送时间错误
contentNull	发送内容为空  --
compCountError	企业帐号不存在  --
usernamePasswordCompCountError	AP名或者密码或者绑定的企业标识错误
beForbid	AP被禁止使用
needBindNumber	没有绑定号码
moneyNotenough	资金不够
messageSuccess	发送成功

 

2、接收短信接口接口定义

接口地址: http://58.53.194.75:8081/swdx/DeliverMsgAction.do?action=getDeliverMsgs&apname=swlh&appassword=swlh&startindex=11817

 

请求参数：

apname  AP名称  appassword   密码    startindex   起始序列号

应答包格式：

<?xml version="1.0" encoding="UTF-8"?>

<Package> <Description> </Description> <totalCount></totalCount><MaxId></MaxId>

<Message>

<DeliverMessage><Id></Id><Userid></Userid><Srctermid></Srctermid><Desttermid></Desttermid><Content></Content><Receivetime></Receivetime></DeliverMessage>

<DeliverMessage><Id></Id><Userid></Userid><Srctermid></Srctermid><Desttermid></Desttermid><Content></Content><Receivetime></Receivetime></DeliverMessage>

<DeliverMessage><Id></Id><Userid></Userid><Srctermid></Srctermid><Desttermid></Desttermid><Content></Content><Receivetime></Receivetime></DeliverMessage>

</Message></Package>

应答参数

接口参数说明如下：

名称	说明
Description	描述
totalCount	总数
MaxId	最大序列
Message	短信列表标志
DeliverMessage	短信信息标志
Id	序列
Userid	用户id
Srctermid	主叫号码
Desttermid	被叫号码
Content	内容
Receivetime	接收时间

 

3、申请通道和调试方法

1.         登录商务领航网站

a)         http://hb.bnet.cn/

2.         点击[企业免费注册]注册一个企业帐号

3.     将帐号交与电信短信接口管理员配置AP帐号：由地市电信客户经理向省电信增值发测试工单（工单需注明客户方技术人员、电信客户经理联系方式，客户的商务领航账号。省增值对应业务部门传真02788187964）

4.     帐号下的主叫号码绑定可点击【企业用户登录】进入，选择商务短信进行绑定电话号码（如外地客户则需绑定湖北地市的需由电信认可电话号码，由电信客户经理代为绑定，必须是电信认可的可计费的固定电话）

5.     湖北省电信增值中心工作人员与客户联系调测短信接口。

6.     接口测试完成之后，由电信客户经理和客户签订业务协议，并向省增值发送正式开通商务短信工单。正式工单格式。

 

以上文档和程序在湖北省通过。