中国移动MM7 API用户手册(二)
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上进行配置,用于路由的查找和状态报告的返回。服务代码以数字表示。
全国业务的服务代码长度统一为4位,即“1000”-“9999”;本地业务服务代码长度统一为5位,即“01000”-“09999”。
以下号码或号段暂不分配:
13XX(XX=00-99)、20XX(XX=01-99)、168X(X=0-9)、186X(X=0-9)、1258/1259、172X(X=0-9)、6XXX、7XXX。
上述代码的分配和使用情况均可以在www.monternet.com上查询。
如果SP已经开展了短信等业务,原则上彩信的服务代码依照SP原有的服务代码进行分配,以保证用户的使用习惯。
目前全网业务的服务代码,由集团公司统一分配。
2.3业务代码
业务代码表示业务类别,并且区分不同业务的信息服务费。业务代码的数据需要在MMSC和BOSS系统中进行配置。业务代码用数字表示,并且不能使用000。
为便于进行业务统计和分析,业务代码尽量按照不同的业务分类如下:
互联网点播类: 以1开头
WAP点播类: 以2开头
短信点播类: 以3开头
STK点播类: 以4开头
彩信点播类: 以0开头
业务代码在遵循原则的前提下其余内容由SP自己制定。
2.3.1上行业务的业务代码规范
上行业务的业务代码为三位,其构成如下:
第1位:0、7、9开头的业务代码保留,其他代码由彩信SP自行编排。
第2~3位:由彩信SP自行编排
特例:如果用户直接给四位服务代码发送上行彩信,系统会默认加上业务代码“0”,该业务代码默认开通,仅用于上行彩信到服务代码。