中国移动MAS机开发手册.docVIP

w 中国移动代理服务器(MAS) 应用插件 开发手册 V1.0 深圳市嘉讯软件有限公司 二○○八年四月 目 录 1 引言 1 1.1 编写目的 1 1.2 背景说明 1 1.3 缩略语和术语 1 1.4 约定 1 2 概述 2 3 应用插件开发步骤 2 4 接口说明 3 4.1 内部API开发应用插件 3 4.1.1 文件格式说明 3 4.2 WebService方式通信适配插件接口 4 4.2.1 Web服务公共数据定义 4 命名空间 4 WEB服务调用方式 5 XML数据类型 5 XML Schema数据类型定义 5 .1 TimeMetricsValues 5 .2 TimeMetric 5 .3 ServiceError 6 .4 SimpleReference 6 .5 CMAbility 6 .6 MessageNotificationType 6 公共异常定义 7 .1 业务异常 7 .2 策略异常 8 1.1.1 应用系统服务通知接口 11 接口说明 11 流程说明 12 接口定义 12 1.1.2 短消息接口 13 接口说明 13 流程说明 13 数据类型 14 接口定义 16 .1. 发送短消息 16 .2. 短消息通知 17 .3. 短消息接收 18 差错定义 18 服务策略 19 1.1.3 多媒体消息接口 19 接口说明 19 流程说明 19 数据类型 20 接口定义 21 .1. 发送彩信 21 .2. 接收彩信 23 .3. 彩信通知 24 1.1.4 定位接口 24 接口说明 24 流程说明 25 数据类型 26 接口定义 27 .1. 定位请求 27 .2. 定位通知 31 差错定义 32 策略异常 32 服务策略 32 1.1.5 WAP PUSH接口 33 接口说明 33 流程说明 33 数据类型 34 接口定义 35 .1. 发送PUSH消息 35 .2. 获取PUSH发送状态 35 1.1.6 USSD业务接口 36 接口说明 36 流程说明 36 数据类型 37 接口定义 37 .1. 连接建立 37 .2. 信息交互 38 .3. 连接终止 38 1.1.7 操作汇总 39 1.2. 数据库方式通信适配插件接口 39 1.2.1 数据库组网方式 39 1.2.2 数据库表结构定义 40 短信数据库表结构 41 .1. 短信待发送表（SMS_OUTBOX） 41 .2. 短信已处理表(SMS_SENT) 42 .3. 上行短信表(SMS_INBOX) 42 定位数据库表结构 43 .1. 定位请求表(LBS_REQUEST) 43 .2. 定位结果表（LBS_RESULT） 44 .3. 周期定位取消表(LBS_CANCEL) 45 彩信数据库表结构 45 .1. 彩信发送表(MMS_OUTBOX) 45 .2. 彩信已处理(MMS_SENT) 46 .3. 彩信接收表(MMS_INBOX) 46 WAPPUSH数据库表结构 47 .1. WAPPUSH待发送表（WAPPUSH_OUTBOX） 47 .2. WAPPUSH已处理表(WAPPUSH_SENT) 48 1.3. PUSHMAIL插件接口 48 1.4. B/S系统移动化插件接口 48 引言 编写目的 本手册详细描述了中国移动代理服务器MAS应用插件开发原理及过程。用于指导利用中国移动代理服务器MAS所提供的插件管理接口实现客户的二次开发需要，满足客户基于短信、彩信、WAP、USSD、LBS等移动信息化的应用开发。 其阅读对象为需要采用中国移动代理服务器MAS完成客户应用插件开发的技术人员。 背景说明 本手册适用于产品“中国移动代理服务器MAS” V2.0版本。 缩略语和术语 缩写 英文名称 中文名称 MAS Mobile Agent Server 移动代理服务器 MMS Multimedia Messaging Service 多媒体短信服务 SMS Short Message Service 短消息业务 SI Service Integrator 服务集成商 约定 文件是以XML格式表达的。在本文档中以表格的形式表示XML格式；以下为表格中对元素约束（出现次数）的表示方法的描述： 元素的约束条件使用以下符号表示 符号 含义 ? 0..1，可选项* 0..n，可以没有，也可以有多项+ 1..n，至少有1项，也可以有多项1 数字1，代表必须且只能填1项WebService方式通信适配插件、数据库方式通信适配插件、API通信适配插件。 WebService方式通信适配插件、数据库方式通信