OpenMas12接口开发文档.doc

目录 1. 概述 3 1.1. 文档概述 3 1.2. 引用标准 3 2. 短信平台业务简介 4 2.1. 短信平台业务定义 4 2.2. 短信平台业务特征 4 3. 接口说明 5 3.1. 短消息WebService接口 5 3.1.1. 业务功能 5 3.1.2. 短信发送接口 6 3.1.3. 短信接收接口 9 3.2. 短信数据库接口 10 3.2.1. 业务功能 11 3.2.2. 短信发送接口 11 3.2.3. 短信接收接口 13 3.3. 彩信WebService接口 14 3.3.1. 业务功能 14 3.3.2. 彩信表示规范 14 3.3.3. 彩信发送接口 17 3.3.4. 彩信接收接口 20 3.4. 彩信数据库接口 22 3.4.1. 业务功能 22 3.4.2. 彩信发送接口 23 3.4.3. 彩信接收接口 25 概述 文档概述 本文档描述了组件与SI/EC平台交互的接口，包括短信、彩信、。 引用标准 [1]中国移动通信集团公司 《省BOSS与业务管理平台（业务平台）接口规范（暂行）》（V1.1.0） [2]中国移动通信集团公司 《全网行业应用业务规范》 [3]中国移动通信集团公司 《中国移动一级BOSS系统接口规范-全网行业应用-SMS业务单行本-IAGW-M部分2.0.0》 [4]中国移动通信集团公司《中国移动一级BOSS系统接口规范V1.4.5》 [5]中国移动通信集团公司《省行业网关开发全网行业应用总体技术要求－报批稿》 [6]中国移动通信集团公司《省BOSS与省行业网关接口规范1.1.2》  短信平台业务简介 短信平台业务定义 短信平台，即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应用环境与移动网络之间的桥梁，为集团客户提供面向移动网络的统一的界面和接口，并可衍生出结合移动终端和其它移动应用的新的应用系统，丰富集团客户应用；对集成集团客户已有系统，短信平台系统可以简化开发流程、缩短开发周期，可以快速在已有应用系统中集成移动化功能，也可以根据短信平台系统开发针对性的移动应用。 短信平台业务特征 与短信平台服务器所具备的特殊地位对应，可以将短信平台服务器的应用分为三个层次。 作为集团客户应用系统的统一移动接入手段：为集团客户应用系统提供包括短信、彩信、USSD、WAP、WEB、定位等在内的统一通信能力。功能的侧重点是提供通信能力的支持。在这个层次，MAS作为统一移动接入能力提供者，不参与业务的核心逻辑； 实现集团客户应用的移动化：将集团客户IT系统的应用环境扩展到移动网络，从而实现移动化的集团客户应用。此时，移动化成为集团客户应用系统必备的功能需求，MAS服务器也成为集团客户应用系统不可或缺的部分。为了实现移动化的需求，集团客户应用系统不需要进行大的改动，在MAS服务器上需对集团客户应用系统的功能进行必要的扩充，MAS服务器成为集团客户应用系统的延伸。 提供新业务：在MAS服务器上运行一个或多个应用模块。MAS服务器提供的应用相对独立，或是由于移动网络环境而衍生出的新的业务系统，这些应用也属于集团客户应用系统的范畴，并与其它集团客户应用系统共同使用MAS服务器所提供的接入和移动化支撑功能。 接口说明 短消息WebService接口 业务功能 集团客户应用系统通过此接口实现短信的收发和状态查询。集团客户应用系统调用SendMessage接口发送短信，短信平台接收请求进行发送。在提交短信发送请求之后， 短信平台根据集团客户预先注册的插件主动通知短信发送状态。 短信发送接口 流程说明 发送接口描述： 集团客户应用系统在短信平台基础组件上注册（并登记状态报告的接收URL），并在短信平台基础组件上生成账号； 集团客户应用系统调用短信平台基础组件的sendMessage接口，发起短信发送的操作； 短信平台接收到短信，然后将短信发送到短信网关； 短信平台接收短信网关的状态报告（结果回执）； 短信平台根据注册的URL，调用基础组件的NotifySmsDeliveryReport方法（带上回执的结果参数）。 集团客户应用系统获取到具体的状态报告信息。 调用方式 接口 接口定义 发起方 落地方 说明 发送短信 SendMessage 应用系统 短信平台 通知发送状态 N