浪潮Mas服务器短信接口说明文档.docVIP

浪潮Mas服务器短信 接口说明 2007-11-1 浪潮通信信息系统有限公司1.1. WebService接口说明 3 1.1.1 Web服务公共数据定义 3 1.1.2 应用系统服务通知接口 10 1.1.3 短消息接口 12 1.1.4 接口调用方式 18 1.1.5 示例代码 22  文档修订历史 版本 日期 修改人 审阅人 摘要 1.0 2007年11月1日 王玉新 创建 1.1 2007年12月5日 田树东 添加了接口调用方式和例子程序 WebService接口说明 WebService方式通信适配插件提供了对各种通信能力的统一封装，供集团客户应用系统和MAS服务器应用插件进行调用。同时，提供统一WebService方式封装也降低了si的开发难度，将繁杂的通信能力协议与具体的业务应用分离开来，对si呈现简单的标准接口。WebService方式通信适配插件接口封装了以下移动通信能力： 短信 彩信 wap ussd LBS 本文档提供了对短信接口的说明。 Web服务公共数据定义 WEB服务调用方式 Mas服务器支持HTTP上的SOAP使可通过HTTP与服务器进行通信。TimeMetricsValues 数据类型为枚举型。 值 描述 Millisecond 毫秒 Second 秒 Minute 分 Hour 小时 Day 日 Week 星期 Month 月 Year 年 TimeMetric 数据类型为结构。 名称 类型 描述 Metric TimeMetricValues 计量单位 Units int 数值 ServiceError 数据类型为结构。 名称 类型 描述 MessageId string 消息标识 Text string 消息说明 Variables string [0..unbounded] 变量 SimpleReference 数据类型为结构。 名称 类型 描述 Endpoint anyURI 端口 InterfaceName string 接口名称 Correlator string 关联标识 CMAbility 数据类型为枚举。 值 描述 SMSbility 对短信能力的需求 MMSAbility 对彩信能力的需求 WAPAbility 对WAP能力的需求 USSDAbility 对USSD能力的需求 LBSAbility 对LBS能力的需求 GPRSAbility 对GPRS能力的需求 MessageNotificationType 用于集团客户应用系统和应用插件通知通信能力需求及所提供的web服务端地址。 数据类型为结构： 名称 类型 描述 CMAbility CMAbility 对应某一个通信能力 WSURI anyURI 对应该通信能力，应用系统或插件提供的WEB服务端地址 公共异常定义 业务异常 业务异常消息使用保留的消息标识符‘SVC’，并使用从0001到0999的号码来定义。其中0001至0199被保留作公共差错定义，0200至0999作为其它Web Service指定用途。从‘1000’至‘9999’为自定义。 名称 类型 描述 MessageId string 消息标识符，前缀为SVC Text string 消息文本，可变可替代部分用%来标识 Variables string [0..unbounded] 替代文本字串中的可变部分 SVC0001: 业务错误 名称 描述 Message Id SVC0001 Text 发生了一个业务错误。错误代码是%1 Variables %1－来自业务的错误码。 SVC0002: 不合法的输入值 名称 描述 Message Id SVC0002 Text 消息部分%1有不合法的输入值。 Variables %1－消息部分。 SVC0003: 不合法的输入值 Message Id SVC0003 Text 消息部分%1有不合法的输入值，%2是合法值。 Variables %1－消息部分； %2－合法值列表。 SVC0004: 不合法地址 名称 描述 Message Id SVC0004 Text 消息部分%1未提供合法地址。 Variables %1－消息部分。 SVC0005: 重复关联符 Message Id SVC0005 Text 消息部分%2中描述的关联符%1是重复的。 Variables %1－关联符。 %2－消息部分。 SVC0006: 不合法的组 名称 描述 Message Id SVC0006 Text 消息部分%2中的组%1不是一个合法的组。 Variables %1－不合法的