《移动企业彩信网关MM7 API用户手册V1》.docVIP

中移MM7 API用户手册 中国移动MM7 API用户手册V1.5.1 PAGE PAGE 21 北京移动MM7 API用户手册 版本：V1.0.0 中国移动集团北京分公司  修改记录 文件编号 版本号 拟制人/ 修改人 拟制/修改日期 更改理由 主要更改内容 （写要点即可） V1.0 程广卫 2006-12-26 修改、整理  目 录 TOC \o 1-4 \h \z 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.概述 该文档说明了企业如何使用北京移动企业彩信平台的的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企业代码 企业代码是企业身份的标识，网络中管理、计费、结算等均以企业代码为依据。企业代码的数据需要在EDSMP系统中进行配置。 在与彩信网关通讯时，企业代码设置成等同与服务代码。 2.2服务代码 服务代码是：用户使用彩信的发送、上传等上行类业务时，需要输入的接收方号码；或企业在根据用户的点播请求在向用户发送、下载等下行类业务时，用户终端中显示的发送方的号码。服务代码的数据需要在MMSC上进行配置，用于路由的查找和状态报告的返回。服务代码以数字