中兴通讯多媒体消息系统MM7 API用户手册V1.5.6

目 录 1.概述 4 2.概念 5 2.1企业代码 5 2.2服务代码 5 2.3业务代码 5 2.3.1上行业务的业务代码规范 6 2.3.2下行业务的业务代码规范 6 2.4操作指令码 9 2.5下行业务 9 2.6上行业务 9 2.7递送报告 9 3.安装方法 10 3.1 MM7 API的使用 10 3.2配置文件的设置 10 4.开发方法 11 4.1 VASP接收传送请求（上行业务） 11 4.2发送多媒体消息的过程（下行业务） 12 4.2.1准备 12 4.2.2创建待发送消息 13 4.2.2.1 创建提交增值业务的多媒体消息（MM7SubmitReq） 13 4.2.2.2 创建取消多媒体消息（MM7CancelReq） 15 4.2.2.3 创建替换多媒体消息（MM7ReplaceReq） 16 4.2.3 创建消息内容体 16 4.2.4 发送多媒体消息 17 4.2.5发送MM7SubmitReq消息到移动终端实例 17 4.3 VASP接收传送消息以及发送提交消息实例 18 4.4 VASP接收状态报告（上行业务） 21 4.5 VASP接收读后回复报告（上行业务） 22 4.6 发送取消消息（下行业务） 23 4.7 发送替换消息（下行业务） 23 5.开发过程中需用的一些Status解释 24 5.1 关于StatusCode和StatusText的解释 24 5.2 关于VASP收到DeliveryReportreq中MMStatus的解释 25 5.3 关于VASP收到ReadReplyReq中ReadStatus的解释 25 6.获取MM7 API版本信息的方法 25 7. MM7 API返回StatusCode说明 26 《中兴通讯多媒体消息系统MM7 API用户手册V1.5.6》是中兴通讯股份有限公司为开发者提供的一份详细指南，旨在帮助用户理解和应用MM7接口进行多媒体消息的处理。手册涵盖了从基本概念到具体操作的全方位指导，以下是其中的关键知识点： 1. **概述**：MM7 API是中兴通讯多媒体消息系统的一部分，它提供了与移动运营商网络交互的接口，允许增值服务提供商(VASP)发送和接收多媒体消息，如图片、音频和视频等内容。API支持上行业务（用户向服务器发送消息）和下行业务（服务器向用户发送消息）。 2. **概念**： - **企业代码**：这是VASP的唯一标识，用于区分不同的服务提供商。 - **服务代码**：指定了特定的服务类型，如新闻订阅、音乐下载等。 - **业务代码**：根据上下行业务的不同，有不同的业务代码规范。上行业务代码规定了用户发起的消息类型，下行业务代码规定了服务器响应或主动发送的消息类型。 3. **操作指令码**：MM7 API提供了各种操作指令，包括创建、发送、取消和替换多媒体消息，以及处理递送报告和读后回复报告。 4. **安装方法**： - **MM7 API的使用**：手册指导如何集成和调用API，以实现多媒体消息的处理功能。 - **配置文件的设置**：详细说明了配置文件的结构和参数设定，以适应不同环境和需求。 5. **开发方法**： - **VASP接收传送请求（上行业务）**：描述了如何处理来自用户的多媒体消息请求。 - **发送多媒体消息的过程（下行业务）**：分为准备阶段、创建消息、创建消息内容体、发送消息等步骤。 - **接收传送消息及发送提交消息实例**：提供了实际操作的示例，帮助开发者理解流程。 - **接收状态报告和读后回复报告**：说明了如何处理用户的反馈信息，如消息送达状态和阅读状态。 - **取消和替换消息**：介绍了如何撤销或更新已发送的消息。 6. **Status解释**： - **StatusCode和StatusText**：解释了API在不同操作中的状态码及其含义，帮助开发者识别和解决错误。 - **DeliveryReportreq中MMStatus**：详细解读了递送报告的状态信息。 - **ReadReplyReq中ReadStatus**：阐述了用户阅读状态的反馈。 7. **获取API版本信息**：提供了获取MM7 API当前版本的方法，以便开发者知道所使用的API的最新特性。 8. **MM7 API返回StatusCode说明**：列出了所有可能返回的StatusCode及其对应的意义，为调试和问题排查提供参考。 手册的每个章节都包含了具体的操作步骤和解释，对开发者来说是非常宝贵的资源，能够帮助他们顺利地集成和使用中兴通讯的多媒体消息系统MM7 API。通过遵循手册中的指导，开发者可以创建高效、稳定且功能丰富的多媒体消息服务。