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