中国移动代理服务器MAS V2.0 WebService接口开发手册
之后,应用侧可以主动获取短信发送状态(getSmsDeliveryStatus操作),或由WebService方式通信适配插件通知应用侧短信发送状态(notifySmsDeliveryStatus操作)。
应用系统或应用插件WebService方式通信适配插件应用主动发起接收短信GetReceivedSmsRequestGetReceivedSmsResponse通知应用短信到达notifySmsReceptionRequestnotifySmsReceptionResponse 图5-3 短消息接收流程示意图
接收短信可以通过两种方式,一种是由应用侧发起(GetReceivedSms操作),WebService方式通信适配插件将所接收到的发往该应用的短信在响应中提交;第二种是由WebService方式通信适配插件通知应用侧有短信到达(notifySmsReception操作),短信内容包含在请求中。
4.1.3. 数据类型
DeliveryStatus 含义:传送状态
数据类型:枚举,定义如下: 参数 Delivered DeliveryUncertain 描述 短消息已成功递交。 递交状态未知:例如,因为短消息被发送到另外一个网络。 DeliveryImpossible MessageWaiting 无法成功发送;短消息在超时前无法被递交。 消息仍在排队等待递交。这是一个临时状态,等待转换为前述的状态之一。 DeliveryToTerminal DeliveryNotificationNotSupp短消息已发给终端。 不支持短消息提交通知。 6
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
orted KeyWordFilterFailed DeliveryInformation 含义:传送消息
数据类型:结构。定义如下: 参数 Address DeliveryStatus SMSMessage 含义:短消息信息
数据类型:结构。定义如下: 参数 Message SmsServiceActivationNumber 类型 xsd:string xsd: anyURI 描述 短消息中的文本。 与被调用的消息业务相关的号码,即,终端用来发送消息的目标地址。 SenderAddress xsd:anyURI 指示短消息发送者的名称,即作为消息发起者显示在用户终端上的名称。 MessageFormat MessageFormat 含义:消息编码类型 数据类型:枚举。定义如下: 参数 ASCII UCS2 GB18030 GB2312 Binary 描述 ASCII字符。 USC2格式的UniCode字符。 GB18030格式的中文字符。 GB2312格式的中文字符。 二进制短信,用十六进制字符串。 MessageFormat 编码格式。 类型 xsd: anyURI DeliveryStatus 描述 目的地址信息。 发送状态。 关键字过滤未通过。 7
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
SendMethodType 含义:发送选项
数据类型:枚举。定义如下: 参数 Normal Instant Long Structured 描述 普通短信 普通短信立即显示 长短信 长度小于160字节,但UDHI需置为1 4.2. 彩信接口
4.2.1.
接口说明
应用系统或应用插件调用发送接口给目的用户发送一条彩信。通信适配插件采用非同步的通知机制将彩信提交状态通知给应用系统或应用插件。对于彩信接收,可以由通信适配插件主动通知应用系统或应用插件有彩信到达,应用系统或应用插件也可通过接口从通信适配插件接收彩信。
4.2.2. 流程说明
应用系统或应用插件WebService方式通信适配插件应用发送彩信sendMessageRequestsendMessageResponse应用主动获取彩信发送状态getMessageDeliveryStatusRequestgetMessageDeliveryStatusResponse通知应用彩信发送状态notifyMessageDeliveryReceiptRequestnotifyMessageDeliveryReceiptResponse 图5-4 发送彩信流程示意图
8
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
发送彩信由应用系统或应用插件发起,通过sendMessage操作实现。在彩信发送之后,应用侧可以主动获取彩信发送状态(getMessageDeliveryStatus操作),或由WebService方式通信适配插件通知应用侧彩信发送状态(notifyMessageDeliveryReceipt操作)。
应用系统或应用插件WebService方式通信适配插件应用主动发起接收彩信GetReceivedMessagesRequestGetReceivedMessagesResponse获取某一条彩信getMessageRequestgetMessageResponse通知应用彩信到达notifyMessageReceptionRequestnotifyMessageReceptionResponse 图5-5 接收彩信流程示意图
接收短信可以通过两种方式,一种是由应用侧发起(GetReceivedMessages操作),WebService方式通信适配插件将发往该应用的彩信的标识在响应中提交,应用侧获取标识之后,可以选择获取某一条彩信(getMessage操作);第二种是由WebService方式通信适配插件通知应用侧有彩信到达(notifyMessageReception操作),在请求中包括彩信内容。
4.2.3. 数据类型
DeliveryStatus 数据类型:枚举 名称 DeliveredToNetwork DeliveryUncertain DeliveryImpossible MessageWaiting DeliveredToTerminal DeliveryNotificationNotSupported 描述 消息成功发送至网络 消息下发状态不确定 消息无法发送。 消息在队列中,尚未发送。 消息成功发送至终端。 不支持消息下发收到通知 9
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
MessagePriority 数据类型:枚举 名称 Default Low Normal High DeliveryInformation 数据类型:结构 参数 address deliveryStatus MessageReference 数据类型:结构 参数 messageIdentifier 类型 xsd:string 可选性 O M M O O 描述 指向某条彩信。如接收彩信为纯文本则此参数无效。 目的地址。 发送方地址。 彩信的标题。 优先级,缺省值为Normal。 若接收彩信为纯文本,则此参数为消息体内容,当此参数存在时,messageIdentifier 参数无效。 消息接收时间 类型 xsd:anyURI DeliveryStatus 描述 消息接收地址 发送状态 描述 缺省消息优先级 低的消息优先级 正常的消息优先级 高的消息优先级 messageServiceActivationNumber xsd:string senderAddress Subject Priority Message xsd:anyURI xsd:string xsd:string MessagePriority M dateTime MmsMessage 数据类型:结构 参数 bodyText Content xsd:dateTime O 类型 xsd: string xsd: string 可选性 M O 描述 彩信消息体的文本部分 与消息一起接收到的数据。MIME组包。 4.3. Wappush短信接口
4.3.1.
接口说明
应用系统或应用插件通过此接口发送WAP PUSH并获取PUSH发送状态。
4.3.2. 流程说明
10
深圳市嘉讯软件有限公司