中国移动MM7_API用户手册.docVIP

中国移动MM7 API用户手册 版本：V1.5.3 中国移动集团公司  修改记录 文件编号 版本号 拟制人/ 修改人 拟制/修改日期 更改理由 主要更改内容 （写要点即可） V1.1 胡冬梅 2004.03.22 修改、整理 V1.2 胡冬梅 2004.04.14 增加内容 增加安装说明 V1.3 胡冬梅 2004.4.21 增加内容 增加状态码等说明 V1.5.1 胡冬梅 2004.5.12 增加内容 增加获取API版本信息、API返回码说明等  目 录 1.概述 5 2.概念 5 2.1企业代码 5 2.2服务代码 6 2.3业务代码 6 2.3.1上行业务的业务代码规范 6 2.3.2下行业务的业务代码规范 8 2.4操作指令码 10 2.5下行业务 11 2.6上行业务 11 2.7递送报告 11 3.安装方法 11 3.1 MM7 API的使用 11 3.2配置文件的设置 11 4.开发方法 13 4.1 VASP接收传送请求（上行业务） 13 4.1.1 方式1：普通应用程序中的用法 13 4.1.2 方式2：Web应用程序中的用法 14 4.2发送多媒体消息的过程（下行业务） 15 4.2.1准备 15 4.2.2创建待发送消息 16 创建提交增值业务的多媒体消息（MM7SubmitReq） 16 创建取消多媒体消息（MM7CancelReq） 18 创建替换多媒体消息（MM7ReplaceReq） 18 4.2.3 创建消息内容体 19 4.2.4 发送多媒体消息 20 4.2.5发送MM7SubmitReq消息到移动终端实例 20 4.3 VASP接收传送消息以及发送提交消息实例 21 4.4 VASP接收状态报告（上行业务） 24 4.4.1方式1：普通应用程序中的用法 24 4.4.2方式2：Web应用程序中的用法 25 4.5 VASP接收读后回复报告（上行业务） 26 4.5.1方式1：普通应用程序中的用法 26 4.5.2方式2：Web应用程序中的用法 27 4.6 发送取消消息（下行业务） 27 4.7 发送替换消息（下行业务） 28 5.开发过程中需用的一些Status解释 29 5.1 关于VASP接收到消息后设置返回响应（Res）的状态码及状态报告的解释 29 5.2 关于VASP收到DeliverReq中MMStatus的解释 30 5.3 关于VASP收到ReadReplyReq中ReadStatus的解释 30 6.获取MM7 API版本信息的方法 30 7. MM7 API返回StatusCode说明 30 1.概述 该文档说明了SP如何使用中国移动集团公司的MM7 API程序与彩信中心进行对接，实现MM7接口的通讯，开发增值业务应用。 该MM7 API是使用纯Java开发的，使用的JDK的版本为JDK1.4.0。所以使用该API进行开发时，要求使用的JDK版本必须是JDK1.4.0以上版本。该API所使用的通讯承载协议是HTTP/1.1。 缩略词： MM： Multimedia Message （多媒体消息） MMS： Multimedia Message Service（多媒体消息服务） MMSC： Multimedia Message Service Center（多媒体消息服务中心） VAS： Value Added Service（增值业务） SP： Service Provider（业务提供商） HTTP： Hypertext Transfer Protocol（超文本传输协议） 2.概念 2.1企业代码 企业代码是企业身份的标识，网络中地址翻译、计费、结算等均以企业代码为依据。企业代码的数据需要在MMSC和BOSS系统中进行配置。企业代码以数字表示，共6位，从“8XY000”至“8XY999”，其中“XY”为各移动分公司代码。 彩信全网业务的SP企业代码为8XY001－8XY999。（目前短信全网业务的企业代码为9XY001－9XY500，WAP全网业务的企业代码为9XY501－9XY999。）彩信地方业务的SP企业代码由各地方移动公司按照业务许可的顺序依次分配制定，“XY”具体分配情况见相关表格。 2.2服务代码 服务代码是：用户使用彩信的发送、上传等上行类业务时，需要输入的接收方号码；或SP在根据用户的点播请求在向用户发送、下载等下行类业务时，用户终端中显示的发送方的号码。服务代码的数据需要在MMSC上进行配置，用于路由的查找和状态报告的返回。服务代码以数字表示。 全国业务的服务代码长度统一为