OpenMas1.2接口开发文档

1、浙江纽科信息科技有限公司 目录1. 概述31.1. 文档概述31.2. 引用标准32. 短信平台业务简介42.1. 短信平台业务定义42.2. 短信平台业务特征43. 接口说明53.1. 短消息WebService接口53.1.1. 业务功能53.1.2. 短信发送接口63.1.3. 短信接收接口93.2. 短信数据库接口103.2.1. 业务功能113.2.2. 短信发送接口113.2.3. 短信接收接口133.3. 彩信WebService接口143.3.1. 业务功能143.3.2. 彩信表示规范143.3.3. 彩信发送接口173.3.4. 彩信接收接口203.4. 彩信数据库接口22

2、3.4.1. 业务功能223.4.2. 彩信发送接口233.4.3. 彩信接收接口251. 概述1.1. 文档概述本文档描述了组件与SI/EC平台交互的接口，包括短信、彩信、。1.2. 引用标准1中国移动通信集团公司 省BOSS与业务管理平台（业务平台）接口规范（暂行）（V1.1.0）2中国移动通信集团公司 全网行业应用业务规范3中国移动通信集团公司中国移动一级BOSS系统接口规范-全网行业应用-SMS业务单行本-IAGW-M部分2.0.04中国移动通信集团公司中国移动一级BOSS系统接口规范V1.4.55中国移动通信集团公司省行业网关开发全网行业应用总体技术要求报批稿6中国移动通信集团公司省

3、BOSS与省行业网关接口规范1.1.22. 短信平台业务简介2.1. 短信平台业务定义短信平台，即Open Mobile Agent Server，其将行业客户的各类应用与移动通信业务应用集成结合，实现SMS（Short Message Service）、USSD（Unstructured Supplementary Service Data）、MMS（Multimedia Messaging Service）、WAP（Wireless Application Protocol）、KJava（Kilo JAVA）等方面的移动数据应用，是沟通集团客户IT应用环境与移动网络之间的桥梁，为集团客户提

4、供面向移动网络的统一的界面和接口，并可衍生出结合移动终端和其它移动应用的新的应用系统，丰富集团客户应用；对集成集团客户已有系统，短信平台系统可以简化开发流程、缩短开发周期，可以快速在已有应用系统中集成移动化功能，也可以根据短信平台系统开发针对性的移动应用。2.2. 短信平台业务特征与短信平台服务器所具备的特殊地位对应，可以将短信平台服务器的应用分为三个层次。ü 作为集团客户应用系统的统一移动接入手段：为集团客户应用系统提供包括短信、彩信、USSD、WAP、WEB、定位等在内的统一通信能力。功能的侧重点是提供通信能力的支持。在这个层次，MAS作为统一移动接入能力提供者，不参与业务的核心

5、逻辑；ü 实现集团客户应用的移动化：将集团客户IT系统的应用环境扩展到移动网络，从而实现移动化的集团客户应用。此时，移动化成为集团客户应用系统必备的功能需求，MAS服务器也成为集团客户应用系统不可或缺的部分。为了实现移动化的需求，集团客户应用系统不需要进行大的改动，在MAS服务器上需对集团客户应用系统的功能进行必要的扩充，MAS服务器成为集团客户应用系统的延伸。ü 提供新业务：在MAS服务器上运行一个或多个应用模块。MAS服务器提供的应用相对独立，或是由于移动网络环境而衍生出的新的业务系统，这些应用也属于集团客户应用系统的范畴，并与其它集团客户应用系统共同使用MAS服务器所

6、提供的接入和移动化支撑功能。3. 接口说明3.1. 短消息WebService接口3.1.1. 业务功能集团客户应用系统通过此接口实现短信的收发和状态查询。集团客户应用系统调用SendMessage接口发送短信，短信平台接收请求进行发送。在提交短信发送请求之后， 短信平台根据集团客户预先注册的插件主动通知短信发送状态。3.1.2. 短信发送接口3.1.2.1. 流程说明发送接口描述：· 集团客户应用系统在短信平台基础组件上注册（并登记状态报告的接收URL），并在短信平台基础组件上生成账号；· 集团客户应用系统调用短信平台基础组件的sendMessage接口，发起短信发送的操

7、作；· 短信平台接收到短信，然后将短信发送到短信网关；· 短信平台接收短信网关的状态报告（结果回执）；· 短信平台根据注册的URL，调用基础组件的NotifySmsDeliveryReport方法（带上回执的结果参数）。· 集团客户应用系统获取到具体的状态报告信息。3.1.2.2. 调用方式接口接口定义发起方落地方说明发送短信SendMessage应用系统短信平台通知发送状态NotifySmsDeliveryStatus短信平台应用系统应用系统必须提前注册对应插件3.1.2.3. 发送方法(SendMessage)发起方：应用系统落地方：短信平台平台st

8、ring SendMessage(string ApplicationID, string Password, string DestinationAddresses, string Message);string SendMessage(string ApplicationID, string Password,string DestinationAddresses, string Message string ExtendCode);备注：消息内容Message为UTF-8编码。请求参数定义1、 ApplicationID：应用程序ID（类型：string）2、 Password：应用程序

9、发送短信密码，用来防止有人恶意模仿应用程序发送短信（类型：string）3、 DestinationAddresses：短信接收方号码，可同时发多人（类型：string数组）4、 ExtendCode：由该应用填写的应用内部扩展号码。（类型：string）5、 Message：短信内容（类型：string）返回值定义6、 返回此次发送信息的唯一标识符，用于用户查询发送状态。(类型：string)3.1.2.4. 状态报告方法 (NotifySmsDeliveryReport)发起方：短信平台平台落地方：应用系统限制条件：应用系统必须注册指定插件void NotifySmsDeliveryRep

10、ort(DeliveryReport deliveryReport);请求参数定义deliveryReport：短信发送状态，与发送请求数组一一对应（类型：DeliveryReport）1、 DeliveryStatus：发送状态（DeliveryStatus），枚举类型0Delivered发送成功。1WaitingForDelivery等待发送。2WaitingForDeliveryStatus已发送,等待状态报告。3DeliveryFailed发送失败。2、 ReceivedAddress：接收方地址（string）3、 StatusCode：状态码，如果发送失败可确定错误原因（strin

11、g）4、 SendAddress：发送地址5、 MessageId：发送标识返回值定义3、无返回值3.1.3. 短信接收接口3.1.3.1. 流程说明·· 接收短信流程说明：· 由应用系统提前在短信平台基础组件注册插件，并登记用于接收短信的URL；· 然后短信平台基础组件从短信网关接收短信信息；· 短信平台组件根据插件注册时登记的URL信息，调用URL对应的NotifySMS方法；· 集团客户应用系统收到短信平台的调用，获取上行短信唯一标识的MessageID；· 集团客户应用系统调用短信平台组件方法（GetMessage）

12、，获取上行短信的详细内容。3.1.3.2. 调用方式接口接口定义发起方落地方说明上行短信通知NotifySms短信平台应用系统应用系统必须提前注册对应插件接收短信GetMessage应用系统短信平台3.1.3.3. 上行短信通知方法(NotifySms)发起方：短信平台平台落地方：应用系统void NotifySms(string MessageID);请求参数定义1、MessageID：上行短信唯一标识，用来获取信息（类型：string）返回值定义2、无返回值3.1.3.4. 接收短信方法(GetMessage)发起方：应用系统落地方：短信平台平台SmsMessage GetMessage(

13、string MessageID);请求参数定义1、 MessageID：上行短信唯一标识（类型：string）返回值定义返回指定应用程序的上行短信。（类型：SmsMessage数组）,类型说明如下：1、 Message：短信正文（string）2、 ReceivedAddress：接收方地址（string）3、 SendAddress：发送方地址（string）3.2. 短信数据库接口集团客户应用系统与短信平台基础组件的数据库可接口，只支持SQL SERVER 2005，同时数据库部署在短信平台基础组件侧。3.2.1. 业务功能集团客户应用系统通过此接口实现短信的收发和状态查询。集团客户应用

14、系统提交待发送短信到数据库，短信平台从数据库中获取待发短信并进行发送。在提交短信发送请求之后， 短信平台回写状态报告到短信发送结果表。3.2.2. 短信发送接口3.2.2.1. 业务流程流程说明:· 应用系统提交待发送短信到中间数据库；· 短信平台基础组件定期从中间数据库中获取待发送短信；· 短信平台基础组件发送短信；· 短信平台基础组件获取短信的状态报告；· 短信平台基础组件提交状态报告到中间数据库；· 应用系统定期从数据库获取状态报告。3.2.2.2. 表结构说明短信待发送表：COM_SmsSent_+扩展号，如：COM_SmsS

15、ent_1字段名数据类型长度必填描述备注IDInt-是主键自动生成MessageIDString50是短信编号必须为唯一值，建议使用GUIDMessageContentString1000否发送的短信内容ExtendCodeString40否接入号扩展码DestinationAddressString40是短信接收手机SendTypeInt-是发送方式0：立即发送；1：定时发送SendTimeDateTime-是发送时间如定时发送请设置发送时间，默认取当前时间。IsWapPushInt-否是否WapPush短信0：否；1：是WapUrlString200否WapPush的Url地址Create

16、TimeDateTime-是创建时间默认当前时间注：短信待发送表中的数据被发送后，短信平台基础组件将自动删除。短信状态报告表：COM_SmsReport_+扩展码，如：COM_SmsReport_1字段名数据类型长度必填描述备注IDInt-是主键标识字段，自动递增MessageIDString50是短信编号必须为唯一值ExtendCodeString40否接入号扩展码DestinationAddressString40是短信接收手机SendStatusInt-否短信提交结果0：成功，其他值为失败GatawayStatusString20否短信发送结果网关返回错误(DELIVRD表示成功)SMS

17、CountInt-是短信发送条数CreateTimeDateTime-是状态报告返回时间注：应用程序务必删除已读取的状态报告，以免表数据越来越大影响性能。另外，如果短信平台从短信网关未获取到状态报告，则短信状态报告表中将没有数据。3.2.3. 短信接收接口3.2.3.1. 业务流程流程说明:· 短信平台基础组件从行业网关获取上行短信；· 短信平台基础组件将上行短信提交到中间数据库；· 应用系统定期从中间数据库获取上行短信。3.2.3.2. 表结构说明短信上行表COM_SmsIn_+扩展码，如：COM_SmsIn_1字段名数据类型长度必填描述备注IDInt-是主键标

18、识字段，自动递增MessageIDString50是短信编号必须为唯一值MessageContentString1000否上行的短信内容SendAddressString40是上行手机号码DestinationAddressString40是基础接入号ExtendCodeString40否接入号扩展码CreateTimeDateTime-否上行时间注：应用程序务必删除已读取的上行短信，以免表数据越来越大影响性能。3.3. 彩信WebService接口3.3.1. 业务功能集团客户应用系统通过此接口实现彩信的收发和状态查询。集团客户应用系统调用SendMessage接口发送彩信，短信平台接收请求

19、进行发送。在提交彩信发送请求之后，集团客户应用系统可以主动请求查询彩信发送状态，或者由短信平台根据集团客户预先注册的插件主动通知彩信发送状态。3.3.2. 彩信表示规范彩信可包含文字、图片和铃声，所以采用XML格式来表示一条彩信。规范如下：元素属性说明<masmms>-根元素<content>contentTypecontentidcontentLocationcharset消息体,出现多次,并且在content中没有出现smil文件,则按顺序显示,如果有smil文件,则按照smil控制显示属性包括:ContentType:mime内容类型Contentid:smil正

20、文中的内容id,如果没有smil,则可自行定义.ContentLocation:媒体对象的文件名Charset: 编码格式,可选 Content-Type支持格式：TEXT : text/plainXML: text/xmlSMIL: application/smilAMR: audio/amrMIDI: audio/midiGIF :image/gifJPEG: image/jpegWBMP: image/vnd.wap.wbmpPNG: image/pngXml示例：<?xml version="1.0" encoding="utf-8"?&g

21、t;<masmms><content contentType="image/gif" charset="" contentId="1.gif" contentLocation="1.gif">R0lGODlhgACAAPf/. hDjEijV1ELSAAOw=</content><content contentType="text/plain" charset="" contentId="1.txt" conten

22、tLocation="1.txt">uafPsreissY=</content><content contentType="application/smil" charset="" contentId="2.smil" contentLocation="2.smil">PHNtaWw+PGhlYWQ+PGxheeT48L3NtaWw+</content></masmms>说明：如果Content中没有SMILl类型文件，文本中文字、图片和音频

23、的显示顺序按照Content在xml中的先后顺序，如果有，则按照SMIL来控制显示。3.3.3. 彩信发送接口3.3.3.1. 流程说明·· 发送流程说明：· 发集团客户应用系统在短信平台基础组件上注册（并登记状态报告的接收URL），并在短信平台基础组件上生成账号；· 集团客户应用系统调用短信平台基础组件的sendMessage接口，发起彩信发送的操作；· 短信平台接收到彩信，然后将彩信发送到彩信网关；· 短信平台接收彩信网关的状态报告（结果回执）；· 短信平台根据注册的URL，调用基础组件的NotifyMmsDeliver

24、yReport方法（带上回执的结果参数）。· 集团客户应用系统获取到具体的状态报告信息。3.3.3.2. 调用方式接口接口定义发起方落地方说明发送彩信SendMessage应用系统短信平台通知发送状态NotifyMmsDeliveryReport短信平台应用系统应用系统必须提前注册对应插件3.3.3.3. 发送方法(SendMessage)发起方：应用系统落地方：短信平台平台string SendMessage(string ApplicationID, string Password,string DestinationAddresses, string Subject, stri

25、ng Content);string SendMessage(string ApplicationID, string Password,string DestinationAddresses, string Subject, string Content, string ExtendCode);string SendMessage(string ApplicationID, string Password,string DestinationAddresses, string Subject, string Content, string ExtendCode, Priority Prior

26、ity);请求参数定义1、 ApplicationID：应用程序ID（string）2、 Password：应用程序发送彩信密码，用来防止有人恶意发送彩信（类型：string）3、 DestinationAddresses：彩信接收方号码，可同时发多人（string数组）4、 ExtendCode：由该应用填写的应用内部扩展号码。5、 Subject：主题（string）6、 Priority：优先级（Priority）值名称描述0Default缺省消息优先级1Low低的消息优先级2Normal正常的消息优先级3High高的消息优先级7、 Content：彩信内容-彩信的xml表示参见3.2.

27、3彩信表示规范。（string）返回值定义7、返回此次发送信息的唯一标识符，用于用户查询发送状态。类型：string3.3.3.4. 彩信发送状态通知接口（NotifyDeliveryStatus）发起方：短信平台平台落地方：应用系统限制条件：应用系统必须注册指定插件void NotifyMmsDeliveryReport(DeliveryReport DeliveryReport);请求参数定义1、 deliveryReport：彩信发送状态（见彩信发送状态表）DeliveryStatus：发送状态（DeliveryStatus），枚举类型0Delivered发送成功。1WaitingFor

28、Delivery等待发送。2WaitingForDeliveryStatus已发送,等待状态报告。3DeliveryFailed发送失败。ReceivedAddress：接收方地址（string）StatusCode：状态码，如果发送失败可确定错误原因（string）SendAddress：发送地址MessageId：发送标识返回值定义3、无返回值3.3.4. 彩信接收接口3.3.4.1. 流程说明·· 接收短信流程说明：· 由应用系统提前在短信平台基础组件注册插件，并登记用于接收彩信的URL；· 然后短信平台基础组件从彩信网关接收短信信息；·

29、 短信平台组件根据插件注册时登记的URL信息，调用URL对应的NotifyMMS方法；· 集团客户应用系统收到短信平台的调用，获取上行彩信唯一标识的MessageID；· 集团客户应用系统调用短信平台组件方法（GetMessage），获取上行彩信的详细内容。3.3.4.2. 调用方式接口接口定义发起方落地方说明上行彩信通知NotifyMms短信平台应用系统应用系统必须提前注册对应插件接收彩信GetMessage应用系统短信平台3.3.4.3. 上行彩信通知方法(NotifyMms)发起方：短信平台平台落地方：应用系统void NotifyMms (string Messag

30、eID);请求参数定义1、MessageID：上行短信唯一表示符，用来获取上行短信（类型：string）返回值定义无返回值3.3.4.4. 接收彩信方法(GetMessage)发起方：应用系统落地方：短信平台平台MmsMessage GetMessage(string MessageID);MmsMessage GetMessage(string ApplicationID, string Password);请求参数定义1、 ApplicationID：应用程序ID（类型：string）2、 MessageID ：短信上行唯一标识（类型：string）3、 Password：应用程

31、序发送彩信密码，用来防止有人恶意获取上行彩信（类型：string）返回值定义返回指定应用程序的上行彩信。（类型：MmsMessage数组）, MmsMessage说明:1、Subject：主题（string）2、ReceivedAddress：接收方地址（string）3、SendAddress：发送方地址（string）4、Content：与消息一起接收到的数据为彩信的xml表示参见4.2.3彩信。（string）5、Priority：优先级。(Priority)6、ReceivedTime：彩信接收时间。（DateTime）3.4. 彩信数据库接口集团客户应用系统与短信平台基础组件的数据库

32、可接口，只支持SQL SERVER 2005，同时数据库部署在短信平台基础组件侧。3.4.1. 业务功能集团客户应用系统通过此接口实现彩信的收发和状态查询。集团客户应用系统提交待发送彩信到数据库，短信平台从数据库中获取待发彩信并进行发送。在提交彩信发送请求之后， 短信平台回写状态报告到彩信发送结果表。3.4.2. 彩信发送接口3.4.2.1. 业务流程流程说明:· 应用系统提交待发送彩信到中间数据库；· 短信平台基础组件定期从中间数据库中获取待发送彩信；· 短信平台基础组件发送彩信；· 短信平台基础组件获取彩信的状态报告；· 短信平台基础组件提交状态报告到中间数据库；· 应用系统定期从数据库获取状态报告。3.4.2.2. 表结构说明彩信待发送表：彩信COM_MmsSent_+扩展号，如：COM_MmsSent