(彩信接口调用说明.docVIP

浪潮MAS开发接口手册 浪潮乐金信息系统有限公司 2009-4-21目录 1. 短信接口 2 1.1. MAS服务器短信接口介绍 2 1.2. MAS服务器短信接口生产webservices客户端 3 1.2.1. 以jbuilder为例，用smseb.wsdl生成客户端类： 3 1.2.2. 不使用jbuilder用smseb.wsdl生成客户端类 5 1.3. MAS服务器Webservices接口调用方法 7 1.4. 参数的含义和取值范围 7 1.5. 错误代码说明 11 2. 彩信接口 12 2.1. MAS服务器彩信接口介绍 12 2.2. MAS服务器彩信接口生产webservices客户端 13 2.3. MAS服务器Webservices接口使用方法 13 短信接口 MAS服务器短信接口介绍 MAS服务器短信接口采用webservice形式，WebService的主要目标是跨平台的可互操作性。为了达到这一目标，WebService完全基于XML（可扩展标记语言）、XSD（XMLSchema）等独立于平台、独立于软件供应商的标准，是创建可互操作的、分布式应用程序的新平台。WebService作為中间层组件，可以直接使用MicrosoftSOAPToolkit或.NET这样的SOAP客户端，也可以使用自己开发的SOAP客户端，然后把它和应用程序连接起来。不仅缩短了开发周期，还减少了代码复杂度，并能够增强应用程序的可维护性应用程序集成WebService，应用程序可以用标准的方法把功能和数据“暴露”出来，供其它应用程序使用 B2B的集成用WebService集成应用程序，可以使公司内部的商务处理更加自动化。但当交易跨越供应商和客户、突破公司的界限时会怎么样呢？跨公司的商务交易集成通常叫做B2B集成。用WebService来实现B2B集成的最大好处在于可以轻易实现互操作性。只要把商务逻辑“暴露”出来，成为WebService，就可以让任何指定 的合作伙伴调用这些商务逻辑，而不管他们的系统在什么平台上运行，使用什么开发语言。这样就大大减少了花在B2B集成上的时间和成本，让许多原本无法承受 EDI的中小企业也能实现B2B集成。软件和数据重用软件重用是一个很大的主题，重用的形式很多，重用的程度有大有小。最基本的形式是源代码模块或者类一级的重用，另一种形式是二进制形式的组件重用。WebService在允许重用代码的同时，可以重用代码背后的数据。使用WebService，再也不必像以前那样，要先从第三方购买、安装软件组件，再从应用程序中调用这些组件；只需要直接调用远端的WebService就可以了22/mas/services/SMSWebServiceAdapter?wsdl（其中的22需要替换成mas服务器的IP） 然后点击前往: 选择添加引用，正确添加后，显示如下： 可以查看一下彩信Webservcie接口所提供的方法： 具体如何调用请参考后一节。 MAS服务器Webservices接口调用方法 参见例子程序包，只需修改其中引入包名为实际包名 修改目标手机号码，运行对应程序即可 参数的含义和取值范围 apCode 参数含义：应用ID或插件的ID,必须和MAS系统中的ID保持一致,必备apPassword 参数含义：webservice接口密码,必备,非空appSeq 参数定义：必备,设置短信的扩展号码，长度不能超过10位,根据管理平台给客户批准的实际号码调整长度不能超过10位destNumber 接收者设置成MAS系统用户ID或手机号码，必备,若填接收手机号码，多个手机号用英文逗号隔开,必须移动手机号MAS系统用户ID或手机号码atTime 定时发送时间，置空则立即发送,可选 inspect 鉴权标志，0是不鉴权，1是鉴权 linkID 该属性没有作用,可选 reqFlag 命令标志，短信发送为4,必备 serviceId 没有意义，可选 sndUID 发送者用户ID timeFlag 0表示实时发送短信，1表示定时发送短信，并且设置定时发送时间 atTime title 短信标题，可选 userFlag 0表示接收者是用户ID，1表示接收者是手机号码 msgContent 短信内容，必备。如果短信是wap push短信，短信内容分为两部分，以|为分隔符，前面是url，后面是内容。例：req.setMsgContent(49/mas/wap |欢迎访问mas wap网站) deliver 是否返回短信发送状态，群发短信不允许状态报告。返回状态报告deliver=1，不返回状态报告deliver=0 wappush wap push 标志 ，2是长短信，1是wap