中国移动彩信协议文档MM7协议.docx
《中国移动彩信协议文档MM7协议.docx》由会员分享，可在线阅读，更多相关《中国移动彩信协议文档MM7协议.docx（44页珍藏版）》请在冰豆网上搜索。
中国移动彩信协议文档MM7协议
MM7接口定义
MMSE除了支持为MMS定义的基本消息传送服务，还支持增值业务。
这些增值业务可能由MMSE的网络运营商提供，也可能由第三方增值服务提供商（VASP）提供。
MM7接口目前必须同时支持长连接和短连接两种形式。
本节定义MMSRelay/ServerRelay/Server和VASP之间的互通情况。
下图说明MM的增殖业务分发中涉与的消息交换数据流实例，如以下摘要消息所示：
图12.1.MM7消息分发数据流实例
后面的小节将指定用于定义MM7协议的摘要消息。
每次发送消息都需要发送鉴权信息。
鉴权方式支持Basic和Digest以与对IP地址鉴权。
对于信息安全敏感的业务，需要在MMSC与SP连接时进行加密，要求MM7接口支持S协议。
发出鉴权消息后则可以得到相应的返回值如下：
0:
成功;
1:
连接失败;
2:
鉴权错误;3:
非法PASSWORD;
3:
系统错误;
具体的鉴权方式参见图12.2和图12.3。
图12.2发送鉴权
图12.3接收鉴权
注：
Basic和Digest鉴权说明参见RFC2617。
同步消息模式
此模式实现多媒体消息的同步操作，MMSC与VASP在发送了多媒体消息后，需等待另一端的回复信息。
也就是说，MM7请求消息从请求中传来后，该MM7请求的响应消息将从响应中返回。
异步消息模式暂不支持。
12.1提交增值业务的多媒体消息
本部分讲述VASP通过将多媒体消息发送至一个或多个用户或发送至一个分发表来提供服务所需执行的操作。
表12.1从类型和方向方面概括了其中涉与的摘要消息。
表12.1：
提交增殖业务消息时涉与到的摘要消息
摘要消息
类型
方向
MM7_submit.REQ
请求
VASP（增殖服务提供商）->MMSRelay/ServerRelay/Server
MM7_submit.RES
响应
MMSRelay/ServerRelay/Server->VASP
12.1.1正常操作
增殖服务提供商（VASP）通过发送MM7_submit.REQ消息，将多媒体消息（MM）作为其有效负荷提供，从而将一个消息提交给MMSRelay/ServerRelay/Server。
可以将消息发往一个或多个用户或发往一个分发表。
如果MMSRelay/ServerRelay/Server接受提交，则MMSRelay/ServerRelay/Server必须发送带一个“成功”状态的MM7_submit.RES。
这并不意味着该多媒体消息（MM）已真正传送至目的地，它只是表明请求已接受。
支持MM7的所有MMSRelay/ServerRelay/Server必须支持MM7_submit.REQ和MM7_submit.RES。
12.1.2异常操作
如果无法认可增殖业务或请求的参数超出所用服务的服务级别，则MMSRelay/ServerRelay/Server将拒绝MM7_submit.REQ。
同样，如果所有目的地都无法解析，则响应状态将指示出错。
如果可以解析一个或多个（但并非所有）地址，则MMSRelay/ServerRelay/Server应将消息传送至这些地址，并使用MM7_submit.RES消息对增殖业务作出响应，并向增殖业务提供商（VASP）指示部分成功。
部分成功并不意味着该多媒体消息已真正传送至目的地，它只是说明请求至少已部分接受。
12.1.3信息单元
表12.2：
MM7_submit.REQ中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_submit.REQ/MM7_submit.RES对的标识。
Messagetype
必备
将此消息标识为MM7_submit请求。
MM7version
必备
标识VASP所支持接口的版本
VASPID
必备
SP代码
VASID
必备
服务代码
Senderaddress
可选
MM始发方的地址。
Recipientaddress
必备
接收方MM的地址。
可能存在多个地址或使用指示使用分发表的别名。
可以标记仅供参考的地址。
Servicecode
必备
业务代码
LinkedID
可选
标识传送至VASP的上一个有效消息的对应关系。
Messageclass
可选
MM的类别（例如，广告、信息服务和计费）
Dateandtime
可选
提交MM的时间和日期（时间戳）。
TimeofExpiry
可选
MM的指定超时时间。
Earliestdeliverytime
可选
将MM传送给接收方的最早理想时间。
Deliveryreport
可选
发送报告的请求。
Readreply
可选
通过请求传送一个读取报告进行确认。
Reply-Charging
可选
应答计费的请求。
Reply-Deadline
可选
在应答计费的情况下，向接收方提交应答的最迟时间。
Reply-Charging-Size
可选
在应答计费的情况下，提供给接收方的应答MM的最大大小。
Priority
可选
消息的优先级（重要性）。
Subject
可选
整个多媒体消息的标题。
Adaptations
可选
指示VASP是否允许修改内容（默认值为“真”）
Chargedparty
可选
指明VASP所提交MM的付费方，例如，发送方、接收方、发送方和接收方或两方均不付费。
ChargedpartyID
可选
在付费方既不是发送方，也不是接收方的情况下，需要使用该字段标识付费方的E.164
Contenttype
必备
MM内容的内容类型。
Content
可选
多媒体消息的内容
MessageDistributionIndicator
可选
如果设置为“假”，则VASP已指示不能重新分发MM的内容。
如果设置为“真”，则VASP已指示可能重新分发MM的内容。
表12.3：
MM7_submit.RES中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_submit.REQ/MM7_submit.RES对的标识。
Messagetype
必备
将此消息标识为MM7_submit响应。
MM7version
必备
标识MMSRelay/ServerRelay/Server所支持接口的版本。
MessageID
视情况而定
如果状态指示成功，则包含MMSRelay/ServerRelay/Server所生成的已提交消息的标识。
此ID可以用于随后与此消息相关的请求和报告。
RequestStatus
必备
完成提交的状态，不隐含传送状态的指示。
RequestStatustext
可选
显示所用状态的文本说明，应限定请求状态。
12.2传送请求
本部分说明MMSRelay/ServerRelay/Server将消息传送给VASP进行处理的情况。
例如，这可能包括消息始发自MMS用户代理的情况。
表12.4从类型和方向方面概括了其中涉与的摘要消息。
表12.4：
从VASP请求服务的摘要消息
摘要消息
类型
方向
MM7_deliver.REQ
请求
MMSRelay/ServerRelay/Server->VASP
MM7_deliver.RES
响应
VASP->MMSRelay/ServerRelay/Server
12.2.1正常操作
MMSRelay/ServerRelay/Server通过将MM作为MM7_deliver.REQ的有效负荷，将消息传送给VASP。
这些消息可能发自MMS用户代理、外部应用程序或外部MMSE。
传送的东西可能包括一个VASP用于关联消息响应的请求标识。
VASP应响应MM7_deliver.RES消息，表明已成功接收并将处理该消息。
下图说明MMS用户代理向要求返回响应的VAS请求某个业务时的数据流用例。
图12.2：
使用MM7_deliver消息与后续响应
支持MM7的MMSRelay/ServerRelay/Server必须支持MM7_deliver.REQ和MM7_deliver.RES。
12.2.2异常操作
如果VASP无法标识所请求的内容，则它应在MM7_deliver.RES状态字段中指示失败。
12.2.3信息单元
表12.5：
MM7_deliver.REQ中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_deliver.REQ/MM7_deliver.RES对的标识。
Messagetype
必备
将此消息标识为MM7_deliver请求。
MM7version
必备
标识MMSRelay/ServerRelay/Server所支持接口的版本。
MMSRelay/ServerID
可选
MMSRelay/ServerRelay/Server的标识符。
LinkedID
可选
VASP在后续MM7_submit.REQ中可能使用的标识符。
Senderaddress
必备
MM始发方的地址。
Recipientaddress
可选
VASP后续处理指定接收方的地址或原始接收方地址。
可以标记仅供参考的地址。
Dateandtime
可选
提交MM的时间和日期（时间戳）。
Reply-Charging-ID
可选
在应答计费的情况下，如果在MM7_deliver.REQ中提交了应答MM，则它指所应答原始MM的标识。
Priority
可选
消息的优先级（重要性）。
Subject
可选
整个MM的标题。
Contenttype
必备
MM内容的内容类型。
Content
可选
多媒体消息的内容。
表12.6：
MM7_deliver.RES中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_deliver.REQ/MM7_deliver.RES对的标识。
Messagetype
必备
将此消息标识为MM7_deliver响应。
MM7version
必备
标识VASP所支持接口的版本。
Servicecode
可选
VASP提供的信息，可能包括在计费信息中。
此信息内容的语法和语义超出此规范的范围。
RequestStatus
必备
请求的完成状态。
RequestStatustext
可选
显示所用状态的文本说明，应限定请求状态。
12.3取消和替换MM
本部分详细说明为允许VASP控制或更改消息分发而应在MM7中支持的请求。
这些操作将允许VASP在传送或使用新消息来替换已提交的消息之前取消已提交的消息。
表12.7从类型和方向方面概括了其中涉与的摘要消息。
表12.7：
控制分发MM的摘要消息
摘要消息
类型
方向
MM7_cancel.REQ
请求
VASP->MMSRelay/ServerRelay/Server
MM7_cancel.RES
响应
MMSRelay/ServerRelay/Server->VASP
MM7_replace.REQ
请求
VASP->MMSRelay/ServerRelay/Server
MM7_replace.RES
响应
MMSRelay/ServerRelay/Server->VASP
下图说明在取消VASP时不同MMS实体间的交互作用情况。
图12.3：
取消提交的消息时VASP的数据流
12.3.1正常操作
如果VASP已决定取消传送提交的MM，则VASP应通过向MMSRelay/ServerRelay/Server发送MM7_cancel.REQ消息指明这一点。
MMSRelay/ServerRelay/Server应检查消息ID所指示消息的状态，并取消向那些没有被它通知的所有目的地传送MM。
MMSRelay/ServerRelay/Server应使用一个MM7_cancel.RES消息对请求作出响应，以表明该请求已被处理过。
如果VASP要提交新的内容，以取代原先提交的内容，则它应使用MM7_replace.REQ消息提交新的替换内容。
MMSRelay/ServerRelay/Server应检查消息ID所指示消息的状态，并对目前为止尚未对该消息接收或尚未将该转发出去的所有目的地进行消息内容替换。
MMSRelay/ServerRelay/Server应从原始MM7_submit.REQ中将新内容重新分发至分发表。
MM7_replace.REQ消息中显示的可选信息单元将替换原始提交中相应的信息单元（VASP不会替换那些在先前发送的通知中已提供的信息单元），MM7_replace.REQ消息中没有的信息单元将保留原始提交值。
对已接收消息的替换将在以后的版本中予以说明。
支持MM7的所有MMSRelay/ServerRelay/Server可以支持或不支持MM7_cancel.REQ、MM7_cancel.RES、MM7_replace.REQ和MM7_replace.RES。
12.3.2异常操作
如果MMSRelay/ServerRelay/Server无法为VAS授权取消或替换MM、找不到请求中指示的消息ID或无法确定所指示消息是否为VASP原先提交的消息，它将拒绝该取消或替换消息的请求。
12.3.3信息单元
表12.8：
MM7_cancel.REQ中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_cancel.REQ/MM7_cancel.RES对的标识。
Messagetype
必备
将此消息标识为MM7_cancel请求。
MM7version
必备
标识VASP所支持接口的版本。
VASPID
可选
标识此MMSRelay/ServerRelay/Server的VASP。
VASID
可选
始发应用程序的标识符。
Senderaddress
可选
MM始发方的地址。
MessageID
必备
待取消的消息的标识符。
表12.9：
MM7_cancel.RES中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_cancel.REQ/MM7_cancel.RES对的标识。
Messagetype
必备
将此消息标识为MM7_cancel响应。
MM7version
必备
标识MMSRelay/ServerRelay/Server所支持接口的版本。
RequestStatus
必备
请求的完成状态。
RequestStatustext
可选
显示所用状态的文本说明，应限定请求状态。
表12.10：
MM7_replace.REQ中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_replace.REQ/MM7_replace.RES对的标识。
Messagetype
必备
将此消息标识为一个MM7_replace请求。
MM7version
必备
标识VASP所支持接口的版本
VASPID
可选
此MMSRelay/ServerRelay/Server的VASP标识符。
VASID
可选
始发应用程序的标识符。
MessageID
必备
被当前消息所替换的消息的标识符。
Servicecode
可选
VASP提供的信息，可能包括在计费信息中。
此信息内容的语法和语义超出此规范的范围。
Dateandtime
可选
提交MM的时间和日期（时间戳）。
Earliestdeliverytime
可选
将MM传送给接收方的指定最早时间。
Readreply
可选
请求通过传送一个读取报告来对消息接收予以确认。
Adaptations
可选
指示VASP是否允许修改内容（默认值为“真”）
Contenttype
视情况而定
MM内容的内容类型。
如果出现内容消息单元，则必须出现内容类型消息单元。
Content
可选
多媒体消息的内容
MessageDistributionIndicator
可选
如果设置为“假”，则VASP指示不能重新分发MM的内容。
如果设置为“真”，则VASP指示可能重新分发MM的内容。
表12.11：
MM7_replace.RES中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_replace.REQ/MM7_replace.RES对的标识。
Messagetype
必备
将此消息标识为一个MM7_replace响应。
MM7version
必备
标识MMSRelay/ServerRelay/Server所支持接口的版本。
RequestStatus
必备
请求的完成状态。
RequestStatustext
可选
显示所用状态的文本说明，应限定请求状态。
12.4到VASP的发送报告
此部分MMS业务讲述生成从MMSRelay/ServerRelay/Server到VASP的发送报告。
表12.12从类型和方向方面概括了其中涉与的摘要消息。
表12.12：
VASP发送报告的摘要消息
摘要消息
类型
方向
MM7_delivery_report.REQ
请求
MMSRelay/ServerRelay/Server->VASP
MM7_delivery_report.RES
响应
VASP->MMSRelay/ServerRelay/Server
12.4.1正常操作
提供相应信息后，MMSRelay/ServerRelay/Server将创建MM7_delivery_report.REQ并将其发送至VASP。
支持MM7的MMSRelay/ServerRelay/Server必须支持MM7_delivery_report.REQ和MM7_delivery_report.RES。
12.4.2异常操作
如果VASP无法标识MMSRelay/ServerRelay/Server或无法识别消息ID，则VASP将响应M7_delivery_report.RES消息，其中包括指示出发送报告被拒绝原因的状态。
12.4.3信息单元
表12.13：
MM7_delivery_report.REQ中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_delivery_report.REQ/MM7_delivery_report.RES对的标识。
MessageType
必备
参考点MM7“MM7_delivery_report.REQ”上所用消息的类型。
MM7Version
必备
MMSRelay/ServerRelay/Server所支持MM7的版本
MMSRelay/ServerID
可选
MMSRelay/ServerRelay/Server的标识符
MessageID
必备
原始MM的标识。
Recipientaddress
必备
原始MM的接收方地址。
Senderaddress
必备
提交原始MM的VAS地址。
Dateandtime
必备
处理（接收、超时、拒绝等）MM的日期和时间（时间戳）
MMStatus
必备
MM的状态，例如已接收、已超时和已拒绝
MMSStatusErrorCode
必选
MM的错误代码传递
MMStatustext
必选
显示所用状态的文本说明，应限定MM状态。
（具体取值含义见附件）
表12.14：
MM7_delivery_report.RES中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_delivery_report.REQ/MM7_delivery_report.RES对的标识。
MessageType
必备
参考点MM7：
“MM7_delivery_report.RES”上所用消息的类型。
MM7Version
必备
VASP所支持MM7的版本。
RequestStatus
必备
关联MM7_delivery_report.REQ的状态。
RequestStatustext
可选
显示所用状态的文本说明，应限定请求状态。
12.5VASP的读后回复报告
此部分MMS业务讲述从MMSRelay/ServerRelay/Server向VASP传送读后回复报告。
表12.15从类型和方向方面概括了其中涉与的摘要消息。
表12.15：
在MM7中发送和接收读后回复报告时用到的摘要消息
摘要消息
类型
方向
MM7_read_reply.REQ
请求
MMSRelay/ServerRelay/Server->VASP
MM7_read_reply.RES
响应
VASP->MMSRelay/ServerRelay/Server
12.5.1正常操作
如果VASP请求了读后回复报告，则接收方MMS用户代理可能创建读后回复并将其发送给MMSRelay/ServerRelay/Server。
MMSRelay/ServerRelay/Server必须确定此读后回复报告与发自MM7参考点的MM相关联，并且必须创建MM7_read_reply.REQ并将其发送给VASP。
VASP应返回一个MM7_read_reply.RES消息，表明读后回复报告已被成功接收。
支持MM7的MMSRelay/ServerRelay/Server必须支持MM7_read_reply_report.REQ和MM7_read_reply_report.RES
12.5.2异常操作
如果VASP无法标识MMSRelay/ServerRelay/Server或无法识别消息ID，则VASP应响应一个MM7_read_reply.RES消息，其中包括指示读后回复报告不被接受的原因的状态。
12.5.3信息单元
表12.16：
MM7_read_reply_report.REQ中的信息单元
信息单元
存在情况
说明
TransactionID
必备
MM7_read_reply_report.REQ/MM7_read_reply_report.RES对的标识。
MessageType
必备
将此消息标识为一个M7_read_reply_report请求。
MM7Version
必备
MMSRelay/ServerRelay/Server所支持MM7的版本。
MMSRelay/ServerID
可选
MMSRelay/ServerRelay/Server的标识符
Recipientaddress
必备
原始MM的MM接收方（即读后回复报告的始发方）地址。
Senderaddress
必备
VASP（原
升级会员 