MAS2.0_WebService插件接口开发手册 2.doc

中国移动代理服务器MAS V2.0 WebService插件接口开发手册中国移动代理服务器MAS V2.0 WebService 接口插件开发手册2010年10月目 录1引言11.1编写目的11.2相关术语与缩略语解释12概述13开发环境24开发步骤24.1MAS服务器应用插件WebService插件参数建立24.2插件管理接口34.2.1接口说明34.2.2流程说明34.2.3数据类型4通讯能力CMAbility44.2.4接口定义64.3应用系统服务通知接口94.3.1接口说明94.3.2流程说明94.3.3接口定义104.3.4短信接口114.3.5彩信接口174.3.5WAP PUSH短信接口2326 1 引言本手册用于指导立通MAS2.0平台上的WebService插件开发。1.1编写目的本文档描述了MAS2.0基座WebService通信接口的使用方法，文档的使用对象为MAS开发人员、数字化部队、SI工程技术人员、SI开发人员、集团客户技术人员。注：本文档的读者需要有一定的WebService相关知识。1.2相关术语与缩略语解释缩写词英文解析中文解析MASMobile Agent Server移动代理服务器HTTPHypertext Transfer Protocol超文本传输协议HTTPSSecure HTTP加密的HTTP协议SOAPSimple Object Access Protocol简单对象访问协议DBDatabaseDB服务接口2概述WebService 方式通信提供了对各种通信能力的统一封装，供集团客户应用系统和MAS服务器应用插件进行调用。同时，提供统一WebService 方式封装也降低了si 的开发难度，将繁杂的通信能力协议与具体的业务应用分离开来，对si呈现简单的标准接口。WebService方式通信适配插件接口封装了以下移动通信能力：l 短信l 彩信l Wappush此外，还提供基座与应用插件之间的插件管理功能接口。MAS 服务器应提供配置工具，指定对于某个集团客户应用系统或应用插件，通过WebService方式通信适配插件或数据库方式通信适配插件接入MAS服务器。3开发环境l JDK：java6l 应用服务器：Tomcat5.5 l 数据库版本：MySQL 5.0.21l WebService工具：AXIS1.44开发步骤插件在使用MAS服务器通信能力之前必须向MAS服务器注册，所以必须先在MAS服务器上建立应用插件的参数信息。4.1MAS服务器应用插件WebService插件参数建立1：运行 MAS2.0服务器，登录到“系统管理”-“MAS配置管理”-“通讯适配插件管理”中进行WebService通讯能力设置。注：通讯能力依赖MAS服务器所拥有的能力而定，只要MAS服务器通过到MAS管理平台鉴权回来拥有短信、彩信、WapPush等能力，这里就可以进行设置。2：创建应用插件参数，进入“配置中心”-“应用插件管理”进行参数配置，如下图红色框部分，“通讯接口方式”必须选择“WebService”，可以根据插件功能需要选择开启某个应用能力。WebServicedi地址：51:80/services/cmcc_mas_wbs4.2插件管理接口4.2.1接口说明插件管理接口实现对应用插件的注册、注销、暂停和恢复，各插件通过此接口报告插件状态。插件管理具体内容包括：插件的注册、注销、启用、暂停插件状态报告。WebService方式通信适配插件作为基座插件管理模块的代理，实现插件管理相关操作信息的处理和转发。4.2.2流程说明插件注册流程说明：MAS服务器系统中应用插件必须注册通过后方可使用，WebService方式通信适配插件将该请求转发到插件管理模块并获得结果，将结果封装在响应消息中返回给应用插件，注册及响应过程通过APRegistration操作实现。应用插件注册通过后，要周期性地进行状态汇报并获取响应，状态报告及响应过程通APStatusRep操作完成。在应用插件运行过程中，根据从MAS统一服务平台得到的业务能力信息，插件管理模块可以主动地发出命令，暂停或恢复特定的插件，这些指令经WebService方式通信适配插件通知给应用插件，通过PauseAP和RecoveryAP两个操作实现。在应用插件结束之前，应用插件主动发起注销操作APLogOut。考虑到一个应用插件可能包含多个进程，因此在上述流程中，注册、状态上报和注销为进程级，而暂停和恢复为插件级。当插件管理模块发现插件进程异常或资源占用超过阀值时，并不停止该进程，而是提示告警给指定人员。插件分为提供Web服务端和不提供Web服务端两种。对于提供Web服务端的情况，要在插件注册操作中指明服务端的URL，对插件的暂停和恢复可以通过PauseAP和RecoveryAP操作，或在状态上报响应中体现；对于不提供Web服务端的情况，对插件的暂停和恢复命令只能在状态上报响应中体现。4.2.3数据类型通讯能力CMAbility数据类型为枚举。值描述SMSbility对短信能力的需求MMSAbility对彩信能力的需求WAPAbility对WAP能力的需求USSDAbility对USSD能力的需求LBSAbility对LBS能力的需求GPRSAbility对GPRS能力的需求MessageNotificationType用于集团客户应用系统和应用插件通知通信能力需求及所提供的web服务端地址。数据类型为结构：名称类型描述CMAbilityCMAbility对应某一个通信能力WSURIxsd:anyURI对应该通信能力，应用系统或插件提供的WEB服务端地址注册结果：APRegResult数据结构：枚举名称描述success注册成功illegalAP插件不被允许，注册失败CMAbilityNotSup不支持所要求的通信能力，注册失败repeatedReg重复注册，注册成功svcAddrMismatch注册请求中的插件Web服务端地址与之前的同一插件其它进程注册请求中的插件Web服务端地址不一致，注册失败。AP运行状态：APStatusType数据结构：枚举名称描述Normal状态正常OutofActiveTime超过有效期NeedRegistration未注册，需要先注册OutofService已经注销Closed插件进程已被mas服务器强行关闭WaitingforConfirm插件的注册请求等待审批中注销结果：APLogoutResult数据结构：枚举名称描述success注销成功illegalAPid插件id不合法，注销失败repeatedLogout重复注销请求AnyUri格式说明：关于anyURI中各类型的格式定义如下：类型格式描述电话号码tel:电话号码表示接收者是一个电话号码群组tel:组名称;type=grp表示接收者是一个群组，用于群发，需要与基座中的地址本管理模块配合使用。部门tel:部门名称;type=dpt表示接收者是一个部门，用于群发，需要与基座中的地址本管理模块配合使用。Web服务地址http:URLURL号码、群组、部门可以组合使用，中间用一个“,”号分开。其它遵循以下标准RFC 2396 Uniform Resource Identifiers (URI): Generic SyntaxRFC 3966 The tel URI for Telephone Numbers/2001/XMLSchema.dtd4.2.4接口定义插件注册由应用插件AP发起进行注册：操作：APRegistration业务触发条件：AP插件启动后，需要自动向WebService适配插件进行注册。注册成功后才能进行其他的正常的调用，否则，WebService适配插件会拒绝该插件后续的所有操作输入：APRegistrationReq参数类型可选性描述Apidxsd: stringMAP插件的标识APPidxsd:intMAP插件的PIDHostIPxsd: stringM主机所在的ip地址MessageNotificationMessageNotificationTypeMAP插件所需的通信能力及各通信能力对应的Web服务URL，若对应某通信能力，Web URL不填，表示对于该应用能力，应用插件不提供服务端。APWSURIxsd: anyURIO应用插件对应的WEB服务端URL，若为空，则表示该应用插件不提供服务端。输出：APRegistrationRsp参数类型可选性描述RegResultAPRegResultM注册响应结果NextIntervalxsd:intM表示AP的后续状态上报时间间隔（单位为秒）差错业务异常： SVC0001 - 业务错误.策略异常： POL0001 - 策略错误.插件状态信息上传由应用插件AP发起，报告插件的状态。操作：APStatusRep业务触发条件：在插件运行过程中，需要周期性地上报自己的运行状态。上报周期可以由MAS服务器进行控制。在状态上报响应消息中，MAS服务器将后续状态上报时间间隔反馈给AP，之后AP按照这个间隔进行上报插件状态。状态上报响应消息中还可携带需要应用插件执行的管理命令，对于不提供服务端的应用插件，状态上报响应是向应用插件发送管理命令的唯一手段。输入：APStatusRepReq参数类型可选性描述APidxsd:stringMAP插件的标识APStatusAPStatusTypeM插件运行状态APPidxsd:intMAP插件的PID输出：APStatusRepRsp参数类型可选性描述NextCommandxsd:stringO需要插件执行的管理命令，pause代表暂停，recovery代表恢复，不填表示无命令。NextIntervalxsd：intO插件的后续上报时间间隔（单位为秒），不填表示同上次时间间隔差错业务异常： SVC0002 - 不合法的输入值.策略异常： POL0001 - 策略错误.注销插件由应用插件AP发起进行注销插件进程。操作：APLogOut业务触发条件：应用插件AP的进程在结束之前，调用此接口进行注销。注销后的进程若重新使用，需要重新进行注册。输入：APLogOutReq参数类型可选性描述APidxsd:stringMAP插件的标识APPidxsd:intMAP插件的PID输出：APLogOutRsp参数类型可选性描述LogoutResultAPLogoutResultM注销响应结果差错业务异常： SVC0001 - 业务错误.策略异常： POL0001 - 策略错误.插件暂停此接口用于暂停AP的业务功能，由WebService插件发起。只有当应用插件有Web服务端的情况，才能使用该操作。操作：PauseAPWebService方式通信适配插件根据插件管理模块的要求，暂停AP的业务功能。如果插件要重新启用，需要在注销后由插件重新发起注册请求；或者由WebService插件重新启动AP。输入：PauseAPReq参数类型可选性描述APidxsd:stringMAP插件的标识输出：PauseAPRsp参数类型可选性描述ACKxsd:BooleanMtrue表示成功，false表示失败。差错业务异常： SVC0001 - 业务错误.策略异常： POL0001 - 策略错误.插件恢复此接口用于恢复AP的业务功能，由WebService方式通信适配插件发起，仅当应用插件有Web服务端时有效。操作：RecoveryAPWebService方式通信适配插件根据业务要求，恢复已暂停的AP的业务功能。输入：RecoveryAPReq参数类型可选性描述APidxsd:stringMAP插件的标识输出：RecoveryAPRsp参数类型可选性描述ACKxsd:BooleanMtrue表示成功，false表示失败。差错业务异常： SVC0001 - 业务错误.策略异常： POL0001 - 策略错误.4.3应用系统服务通知接口4.3.1接口说明此接口用于集团客户应用系统完成对短消息、多媒体消息、定位和USSD相关的服务通知。集团客户应用系统通过此接口通知WebService方式通信适配插件各通信能力对应的服务端URL，以及服务端是否开启或关闭。4.3.2流程说明对于应用系统支持服务端的情况，需要通过startNotification操作通知WebService方式通信适配插件各个通信能力对应的服务端URL，之后WebService方式通信适配插件可以调用服务端向应用系统发出各种消息通知，直到应用系统通过stopNotification通知服务端不可用为止。应用系统可以多次执行startNotification和stopNotification操作，WebService方式通信适配插件以最后一次的通知为准。WebService方式通信适配插件在向应用侧发出消息通知失败时，采用指数后退方式重试三次。若重试后仍失败，则抑制后续的所有消息通知。4.3.3接口定义操作：startNotificationstartNotification调用由应用系统发起，通知WebService方式通信适配插件，应用系统的服务端已经开启。应用系统在MessageNotification参数中注明各通信能力对应的服务端URL。输入：startNotificationRequest参数类型可选性描述ApplicationIdxsd:stringMEC应用标识MessageNotificationMessageNotificationTypeM应用的各通信能力对应的Web服务URL，若对应某通信能力，Web URL不填，表示对于该应用能力，应用插件不提供服务端，或服务端不可用。输出：startNotificationResponse无。差错：业务异常： SVC0001 - 业务错误. SVC0002 - 不合法的输入值. SVC0005 - 重复关联符.策略异常： POL0001 - 策略错误.操作：stopNotificationstopNotification调用由应用系统发起，通知WebService方式通信适配插件该应用系统不再提供服务端。输入：stopNotificationRequest参数类型可选性描述ApplicationIdxsd: stringMEC应用ID输出：stopNotificationResponse无。差错业务异常： SVC0001 - 业务错误. SVC0002 - 不合法的输入值.策略异常：POL0001 - 策略错误.4.3.4短信接口接口说明集团客户应用系统和应用插件通过此接口收发短消息。WebService方式通信适配插件收到应用插件的发送请求后，通过MAS服务器基座中的SMS通信协议模块发送SMS；当从SMS通信协议模块收到SMS后，通过此接口将短消息发送给集团客户应用系统和应用插件。流程说明短消息接口包括发送和接收两个流程。发送短信由应用系统或应用插件发起，通过sendSms操作实现。在提交短信发送请求之后，应用侧可以主动获取短信发送状态（getSmsDeliveryStatus操作），或由WebService方式通信适配插件通知应用侧短信发送状态（notifySmsDeliveryStatus操作）。接收短信可以通过两种方式，一种是由应用侧发起（GetReceivedSms操作），WebService方式通信适配插件将所接收到的发往该应用的短信在响应中提交；第二种是由WebService方式通信适配插件通知应用侧有短信到达（notifySmsReception操作），短信内容包含在请求中。数据类型DeliveryStatus含义：传送状态数据类型：枚举，定义如下：参数描述Delivered短消息已成功递交。DeliveryUncertain递交状态未知：例如，因为短消息被发送到另外一个网络。DeliveryImpossible无法成功发送；短消息在超时前无法被递交。MessageWaiting消息仍在排队等待递交。这是一个临时状态，等待转换为前述的状态之一。DeliveryToTerminal短消息已发给终端。DeliveryNotificationNotSupported不支持短消息提交通知。KeyWordFilterFailed关键字过滤未通过。DeliveryInformation含义：传送消息数据类型：结构。定义如下：参数类型描述Addressxsd: anyURI目的地址信息。DeliveryStatusDeliveryStatus发送状态。SMSMessage含义：短消息信息数据类型：结构。定义如下：参数类型描述Messagexsd:string短消息中的文本。SmsServiceActivationNumberxsd: anyURI与被调用的消息业务相关的号码，即，终端用来发送消息的目标地址。SenderAddressxsd:anyURI指示短消息发送者的名称，即作为消息发起者显示在用户终端上的名称。MessageFormatMessageFormat编码格式。MessageFormat含义：消息编码类型数据类型：枚举。定义如下：参数描述ASCIIASCII字符。UCS2USC2格式的UniCode字符。GB18030GB18030格式的中文字符。GB2312GB2312格式的中文字符。Binary二进制短信，用十六进制字符串。SendMethodType含义：发送选项数据类型：枚举。定义如下：参数描述Normal普通短信Instant普通短信立即显示Long长短信Structured长度小于160字节，但UDHI需置为接口定义.1发送短信操作：sendSmssendSms调用是由应用系统或插件发起，请求发送一条短消息到一个指定地址（或地址集合），该短消息由Message描述，目的地址由DestinationAddress描述。对于可任意扩展服务代码的应用，应用可以通过ExtendCode填写应用内部的扩展码，MAS服务器需自动在其前面补充为该业务分配的长服务号码。对本接口的调用，MAS服务器应返回RequestIdentifier标识这次发送请求。如果消息的长度大于可支持的最大长度，此条消息将被分成若干条短消息进行发送。应用通过DeliverResultRequest告知是否需要返回状态报告。MAS根据要求用notifySmsDeliveryStatus接口返回状态报告。输入：sendSmsRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件的ID。DestinationAddressesxsd:anyURI 0.unboundedM短消息要被发送到的地址。群发短消息的最大数量为254。ExtendCodexsd:stringO指由该应用填写的内部扩展号码。MAS服务器需自动补充为此业务分配的长服务号码。Messagexsd：stringM在短消息中发送的文本。MessageFormatMessageFormatM消息编码类型。SendMethodSendMethodTypeM发送消息选项。DeliveryResultRequestxsd:booleanO指示是否需要网络侧返回递交状态报告。若无，则不返回。True表示需要网络侧返回递交状态报告，false表示不需要网络侧返回递交状态报告。输出：sendSmsResponse参数类型可选性描述RequestIdentifierxsd:stringM标识一个特定的短消息发送请求。差错业务异常： SVC0001 - 业务错误. SVC0002 - 不合法的输入值. SVC0004 - 不合法地址. SVC0006 - 不合法的组. SVC0280 - 消息过长.策略异常： POL0001 - 策略错误. POL0003 地址超界. POL0006 - 组不被允许. POL0007 - 嵌套的组不被允许. POL0008 - 不允许支付.操作：GetSmsDeliveryStatus用于集团客户应用系统或应用插件查询短消息的发送状态。集团客户应用系统或应用插件通过requestIdentifier指定查询对应的发送请求，状态信息由DeliveryStatus返回。输入：GetSmsDeliveryStatusRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件ID。RequestIdentifierxsd:stringM在发送短信时由WebService方式通信适配插件分配的发送请求标识。输出：GetSmsDeliveryStatusResponse参数类型可选性描述DeliveryStatusDeliveryInformation0.unboundedM列出短消息发送状态。差错业务异常: SVC0001 - 业务错误. SVC0002 - 不合法的输入值.策略异常： POL0001 - 策略错误.2短消息通知操作：notifySmsReception通信适配插件收到发送到特定地址的短消息时，调用本接口，通知集团客户应用系统和应用插件有短消息到达，前提是应用系统或插件具备Web服务端。输入：notifySmsReceptionRequest参数类型可选性描述MessageSmsMessageM在短消息中发送的文本。输出：notifySmsReceptionResponse无。差错无。操作：notifySmsDeliveryStatus应用系统或应用插件通过通信适配插件发送了短消息之后，通信适配插件对该短消息的发送分配了一个标识符RequestIdentifier。当通信适配插件获得状态报告后，调用本接口将短消息的发送状态报告给应用侧，前提是应用系统或插件具备Web服务端。状态信息在DeliveryInfomation中具体描述。输入：notifySmsDeliveryStatusRequest参数类型可选性描述RequestIdentifierxsd:stringM标识一个短消息发送请求。DeliveryInformationdeliveryInformation0.unboundedM短消息递交状态参数。输出：notifySmsDeliveryStatusResponse无。差错：无。.3短消息接收操作：GetReceivedSms用于集团客户应用系统和应用插件从通信适配插件获取接收到的短消息。通信适配插件返回receivedSms，包含短消息的发送者和内容。输入：GetReceivedSmsRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件ID。输出：GetReceivedSmsResponse参数类型可选性描述ReceivedSmsSmsMessage 0.unboundedM接收的短消息差错：业务异常: SVC0001 - 业务错误. SVC0002 - 不合法的输入值.策略异常： POL0001 - 策略错误.4差错定义业务异常SVC0280: 消息过长参数描述Message IdSVC0280Text消息过长。最大长度是%1字符。Variables%1在一个消息中允许的字符的数目。SVC0281: 未知的数据格式参数描述Message IdSVC0281Text消息部分%1的数据格式不被认识。Variables%1带有不被认识的数据格式的消息。.5服务策略服务策略在MAS服务器上进行配置。参数类型描述GroupSupportxsd:boolean组可被包含在地址中。NestedGroupSupportxsd:boolean在组定义中支持嵌套的组。AllowNotificationxsd:Boolean是否支持通知。Maximum of Messagexsd: int南向接口消息内容大小的最大值，超过进行拆分。4.3.5彩信接口接口说明应用系统或应用插件调用发送接口给目的用户发送一条彩信。通信适配插件采用非同步的通知机制将彩信提交状态通知给应用系统或应用插件。对于彩信接收，可以由通信适配插件主动通知应用系统或应用插件有彩信到达，应用系统或应用插件也可通过接口从通信适配插件接收彩信。流程说明发送彩信由应用系统或应用插件发起，通过sendMessage操作实现。在彩信发送之后，应用侧可以主动获取彩信发送状态（getMessageDeliveryStatus操作），或由WebService方式通信适配插件通知应用侧彩信发送状态（notifyMessageDeliveryReceipt操作）。接收短信可以通过两种方式，一种是由应用侧发起（GetReceivedMessages操作），WebService方式通信适配插件将发往该应用的彩信的标识在响应中提交，应用侧获取标识之后，可以选择获取某一条彩信（getMessage操作）；第二种是由WebService方式通信适配插件通知应用侧有彩信到达（notifyMessageReception操作），在请求中包括彩信内容。数据类型DeliveryStatus数据类型：枚举名称描述DeliveredToNetwork消息成功发送至网络DeliveryUncertain消息下发状态不确定DeliveryImpossible消息无法发送。MessageWaiting消息在队列中，尚未发送。DeliveredToTerminal消息成功发送至终端。DeliveryNotificationNotSupported不支持消息下发收到通知MessagePriority数据类型：枚举名称描述Default缺省消息优先级Low低的消息优先级Normal正常的消息优先级High高的消息优先级DeliveryInformation数据类型：结构参数类型描述addressxsd:anyURI消息接收地址deliveryStatusDeliveryStatus发送状态MessageReference数据类型：结构参数类型可选性描述messageIdentifierxsd:stringO指向某条彩信。如接收彩信为纯文本则此参数无效。messageServiceActivationNumberxsd:stringM目的地址。senderAddressxsd:anyURIM发送方地址。Subjectxsd:stringO彩信的标题。PriorityMessagePriorityM优先级，缺省值为Normal。Messagexsd:stringO若接收彩信为纯文本，则此参数为消息体内容，当此参数存在时，messageIdentifier 参数无效。dateTimexsd:dateTimeO消息接收时间MmsMessage数据类型：结构参数类型可选性描述bodyTextxsd: stringM彩信消息体的文本部分Contentxsd: stringO与消息一起接收到的数据。MIME组包。接口定义.1发送彩信应用系统或应用插件通过SendMessage操作发送彩信，之后通过GetMessageDeliveryStatus获取已发送彩信的发送状态。操作：sendMessage用于集团客户应用系统和应用插件向通信适配插件提交发送彩信（包括标题和内容）请求，并指明是否需要网络侧返回状态报告。本操作支持群发。在响应中，通信适配插件返回对本次请求的标识。输入：sendMessageRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件IDaddressesxsd:anyURI 0.unboundedM消息要被发送到的地址。.ExtendCodexsd:stringO指由该应用填写的应用内部扩展号码。MAS服务器需自动补充为此业务分配的服务号码。subjectxsd:stringO本参数指示消息的主题。priorityMessagePriorityO本参数代表消息的优先级。如果未指明，按缺省优先级处理。receiptRequestxsd: booleanO指示是否需要返回递交状态报告。true表示需要，false表示不需要。若无，则不返回。Contentxsd: stringO和消息一起发送的数据。输出：sendMessageResponse参数类型可选性描述requestIdentifierxsd:stringM标识本次发送请求，用于getMessageDeliveryStatus调用。差错：业务异常： SVC0001 业务错误 SVC0002 非法输入值 SVC0004 非法地址 SVC0006 非法组 SVC0283 不支持下发到达通知策略异常： POL0001 策略错误 POL0006 组不被允许 POL0007 嵌套组不被允许 POL0008 计费不被支持操作：getMessageDeliveryStatus获取已提交发送的消息的发送状态。requestIdentifier参数为发送请求标识。输入：getMessageDeliveryStatusRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件IDrequestIdentifierxsd:stringM发送请求标识。输出：getMessageDeliveryStatusResponse参数类型可选性描述resultDeliveryInformation 0.unboundedM消息发送状态。差错业务异常： SVC0001 业务错误 SVC0002 -不合法的输入值策略异常： POL0001 -策略错误.2接收彩信操作：getReceivedMessages应用及插件通过此操作接收彩信，在请求中指明优先级。若有发往该应用系统或应用插件的彩信，则在响应中列出。输入：getReceivedMessagesRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件IDpriorityMessagePriorityO指定要接收的彩信的优先级，要求返回高于或等于该优先级的彩信。若未指定，则返回所有彩信。输出：getReceivedMessagesResponse参数类型可选性描述receivedMessageMessageReference 0.unboundedO包括一组收到根据指定过滤注册标识符和优先权的消息。差错业务异常： SVC0001 -业务错误 SVC0002 -不合法的输入值策略异常： POL0001 -策略错误操作：getMessage这个操作将读取整条彩信。在请求中指定消息的标识（该标识对应getReceivedMessagesResponse中MessageReference的messageIdentifier参数），在返回的响应中，包含与消息一起接收到的数据。输入：getMessageRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件IDmessageRefIdentifierxsd:stringM消息标识输出：getMessageResponse参数类型可选性描述mmsMessagexsd: MmsMessageNo彩信消息差错业务异常： SVC0001 -业务错误 SVC0002 -不合法的输入值策略异常： POL0001 -策略错误.3彩信通知对于应用系统或应用插件有彩信服务端的情况，通信适配插件通过notifyMessageReception操作通知应用系统或应用插件接收到的彩信，通过notifyMessageDeliveryStatus通知应用系统或应用插件已发送彩信的发送状态。操作：notifyMessageReception用于通知应用系统或应用插件接收到的彩信。在请求中包含彩信的所有信息及数据。输入：notifyMessageReceptionRequest参数类型可选性描述ApplicationIDxsd:stringM应用ID或插件IDmessageMessageReferenceM与接收消息相关的所有信息Contentxsd: stringO与消息一起接收到的数据。输出：notifyMessageReceptionResponse无。差错无。操作：notifyMessageDeliveryReceipt用于通知应用系统或应用插件已发送彩信的发送状态。输入：notifyMessageDeliveryReceiptRequest参数类型可选性描述correlatorxsd:stringM标识某一个消息发送请求。deliveryStatusDeliveryInformation 0.unboundedM消息发送状态输出：notifyMessageDeliveryReceiptResponse无。差错None.4.3.5WAP PUSH短信接口接口说明应用系统或应用插件通过此接口发送WAP PUSH并获取PUSH发送状态。流程说明当有WAP PUSH消息要发送时，应用侧调用SendPush操作发送PUSH消息，之后通过getPushDeliveryStatus主动获取PUSH的发送状态。当应用系统或应用插件提供web服务端时，webservice方式通信适配插件也可通过notifyPushDeliveryReceipt操作通知应用侧PUSH发送状态。数据类型DeliveryStatus数