1、中国移动 MM7 API 用户手册版本：V1.5.1中国移动集团公司中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.12修改记录文件编号 版本号 拟制人/修改人 拟制/修改 日期 更改理由 主要更改内容（写要点即可）V1.1 胡冬梅 2004.03.22 修改、整理V1.2 胡冬梅 2004.04.14 增加内容 增加安装说明V1.3 胡冬梅 2004.4.21 增加内容 增加状态码等说明V1.5.1 胡冬梅 2004.5.12 增加内容 增加获取 API 版本信息、API 返回码说明等中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.13
2、目 录1.概述 .52.概念 .52.1 企业代码 .52.2 服务代码 .62.3 业务代码 .62.3.1 上行业务的业务代码规范 .62.3.2 下行业务的业务代码规范 .82.4 操作指令码 .102.5 下行业务 .112.6 上行业务 .112.7 递送报告 .113.安装方法 .113.1 MM7 API 的使用 .113.2 配置文件的设置 .114.开发方法 .134.1 VASP 接收传送请求（上行业务） .134.1.1 方式 1：普通应用程序中的用法 .134.1.2 方式 2：Web 应用程序中的用法 .144.2 发送多媒体消息的过程（下行业务） .154.2.1
3、准备 .154.2.2 创建待发送消息 .164.2.2.1 创建提交增值业务的多媒体消息（MM7SubmitReq） .164.2.2.2 创建取消多媒体消息（MM7CancelReq） .184.2.2.3 创建替换多媒体消息（MM7ReplaceReq） .184.2.3 创建消息内容体 .194.2.4 发送多媒体消息 .204.2.5 发送 MM7SubmitReq 消息到移动终端实例 .204.3 VASP 接收传送消息以及发送提交消息实例 .214.4 VASP 接收状态报告（上行业务） .244.4.1 方式 1：普通应用程序中的用法 .244.4.2 方式 2：Web 应用程
4、序中的用法 .254.5 VASP 接收读后回复报告（上行业务） .264.5.1 方式 1：普通应用程序中的用法 .264.5.2 方式 2：Web 应用程序中的用法 .274.6 发送取消消息（下行业务） .274.7 发送替换消息（下行业务） .285.开发过程中需用的一些 Status 解释 .295.1 关于 VASP 接收到消息后设置返回响应（Res）的状态码及状态报告的解释 .29中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.145.2 关于 VASP 收到 DeliverReq 中 MMStatus 的解释 .305.3 关于 VASP 收到 Re
5、adReplyReq 中 ReadStatus 的解释 .306.获取 MM7 API 版本信息的方法 .307. MM7 API 返回 StatusCode 说明 .30中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.151.概述该文档说明了 SP 如何使用中国移动集团公司的 MM7 API 程序与彩信中心进行对接，实现MM7 接口的通讯，开发增值业务应用。该 MM7 API 是使用纯 Java 开发的，使用的 JDK 的版本为 JDK1.4.0。所以使用该 API 进行开发时，要求使用的 JDK 版本必须是 JDK1.4.0 以上版本。该 API 所使用的通讯承
6、载协议是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
7、 和 BOSS 系统中进行配置。企业代码以数字表示，共 6 位，从“8XY000”至“8XY999”，其中“XY”为各移动分公司代码。彩信全网业务的 SP 企业代码为 8XY0018XY999。 （目前短信全网业务的企业代码为9XY0019XY500，WAP 全网业务的企业代码为 9XY5019XY999。 ）彩信地方业务的 SP 企业代码由各地方移动公司按照业务许可的顺序依次分配制定， “XY”具体分配情况见相关表格。2.2 服务代码服务代码是：用户使用彩信的发送、上传等上行类业务时，需要输入的接收方号码；或 SP中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.1
8、6在根据用户的点播请求在向用户发送、下载等下行类业务时，用户终端中显示的发送方的号码。服务代码的数据需要在 MMSC 上进行配置，用于路由的查找和状态报告的返回。服务代码以数字表示。全国业务的服务代码长度统一为 4 位，即“1000”“9999” ；本地业务服务代码长度统一为 5 位，即“01000”“09999” 。以下号码或号段暂不分配：13XX（XX00-99） 、20XX（XX0199） 、168X（X0-9） 、186X（X=0-9） 、1258/1259、172X（X=0-9） 、6XXX、7XXX。上述代码的分配和使用情况均可以在 上查询。如果 SP 已经开展了短信等业务，原则
9、上彩信的服务代码依照 SP 原有的服务代码进行分配，以保证用户的使用习惯。目前全网业务的服务代码，由集团公司统一分配。2.3 业务代码业务代码表示业务类别，并且区分不同业务的信息服务费。业务代码的数据需要在 MMSC和 BOSS 系统中进行配置。业务代码用数字表示，并且不能使用 000。为便于进行业务统计和分析，业务代码尽量按照不同的业务分类如下：互联网点播类： 以 1 开头WAP 点播类： 以 2 开头短信点播类： 以 3 开头STK 点播类： 以 4 开头彩信点播类： 以 0 开头业务代码在遵循原则的前提下其余内容由 SP 自己制定。2.3.1 上行业务的业务代码规范上行业务的业务代码为三
10、位，其构成如下：第 1 位：0、7、9 开头的业务代码保留，其他代码由彩信 SP 自行编排。第 23 位：由彩信 SP 自行编排特例：如果用户直接给四位服务代码发送上行彩信，系统会默认加上业务代码“0” ，该业务中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.17代码默认开通，仅用于上行彩信到服务代码。2.3.2 下行业务的业务代码规范下行业务的业务代码为六位，其构成如下：第 1 位：功能标识位，目前有如下两种选择： 1，代表一般下行业务 7，代表用于“先机时代”项目中手机内置并参与渠道分成的业务 6，代表用于集团客户应用的业务（免费）其他数字目前保留。第 2 位：
11、彩信业务一级分类，具体如下面表格：第 3 位：彩信业务二级分类，具体如下面表格：一级分类及标识代码 二级分类及标识代码新闻天气（1） 天气预报（1）热点快讯（2）社会新闻（3）体育新闻（4）娱乐新闻（5）财经新闻（6）综合新闻（0）游戏娱乐（2） 聊天交友（1）笑话幽默（2）彩信游戏（3）影音视线（4）互动有奖（5）五花八门（0）时尚生活（3） 时尚有约（1）车迷世界（2）文化教育（3）中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.18情感画廊（4）爱情家庭（5）两性健康（6）证券财经（7）位置服务（8）五花八门（0）卡通动漫（4） 欧美（1）日本（2）韩国（3）
12、港台（4）本地原创（5）五花八门（0）彩信铃声（5） 明星专辑（1）精品影视（2）流行音乐（3）古典音乐（4）卡拉 OK（5）特殊音效（6）五花八门（0）彩图动画（6） 人物剪影（1）动物一族（2）美丽心情（3）温馨祝福（4）电影名画（5）中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.19体育纵横（6）大千世界（7）3D 动画（ 8）五花八门（0）彩信 DIY（7） 贺卡类（1）形象类（2）文字类（3）五花八门（0）特色用途（0） 免费客服（1）优惠套餐（2）第 4 位：业务模式位，各个模式及其数字标识如下： 1：按条点播 2：按条定制 3：包月定制 4：包月点播
13、第 56 位：由彩信 SP 自行编排2.4 操作指令码操作指令码是指用户通过短信点播或定制彩信业务时，在短信的信息体内输入的代码，或用户上行发送彩信时，在彩信消息体内的文本信息中输入的代码。操作指令码用于标识对彩信的中移 MM7 API 用户手册 中国移动 MM7 API 用户手册V1.5.110处理方式。此代码出现在短信或彩信的消息体内，由 SP 自行处理，彩信中心不负责处理该代码。在短信中输入的操作指令码应严格区分用户是点播、定制短信业务还是彩信业务。如果用户通过短信点播或定制彩信业务，操作指令码应以 CX 开头。如：用户在短信或彩信文本信息体内输入“CX XW”发送至 8888，就是定制
14、新浪提供的彩信图片新闻业务。2.5 下行业务由 SP 主动发起的业务。这里主要指 SP 向 MMSC 发起的业务。2.6 上行业务SP 被动接收的业务。这里主要指从 MMSC 那里接收业务。2.7 递送报告报告是接收方（终端）对接收到消息的处理方式信息。递送报告指 MMSC 在获取这个报告后把这个信息发送给发送方（SP） 。接收方对消息的处理可能是接收或者拒绝等。处理流程如下： SP 发送消息（通过 MMSC）给终端，并且要求递送报告； 终端接收到消息后做相应处理（接收或拒绝） ； MMSC 把终端对消息的处理信息（递送报告）发送给 SP。3.安装方法这里主要介绍一下如何将 MM7 API 运用到 VASP 自己开发的程序中以及在配置文件中需要注意修改的地方。3.1 MM7 API 的使用在 VASP 用 Java 开发自己程序时，只要将中国移动集团公司提供的 mm7api.jar 和 lib 下的所有的
