中国移动飞信平台飞信业务接口规范 彩信接口分册 100报批稿.docx

1、中国移动飞信平台飞信业务接口规范 彩信接口分册 100报批稿中国移动通信企业标准QB-飞信业务接口规范彩信接口分册Fetion Interface Specification for Multimedia Message Service版本号：1.0.0-实施-发布中国移动通信集团公司 发布目 录前 言 II1. 范围 12. 规范性引用文件 13. 术语、定义和缩略语 13.1. 术语、定义 13.2. 缩略语 14. 业务概述 24.1. 业务特征 24.2. 资费说明 25. 系统结构 25.1. 系统结构图 25.2. 接口概述 35.3. 接口安全性要求 35.3.1. 飞信PC客户

2、端发送彩信的安全机制 35.3.2. 自写彩信页面加载的安全机制 45.3.3. 彩信内容ID及彩信内容的安全机制 45.3.4. 通信安全机制 45.4. 彩信发送机制 45.4.1. 彩信内容ID的分配原则 45.4.2. 发送流程 56. 接口定义 66.1. 飞信PC客户端与飞信平台间的接口 66.1.1. 飞信PC客户端发送彩信接口 66.2. 飞信PC客户端与MDA平台间的接口 86.2.1. 自写彩信页面加载接口 86.2.2. 彩信库标签页加载接口 86.2.3. 从彩信库标签页打开新页面接口 96.2.4. 从彩信库页面中选择素材并编辑彩信接口 96.2.5. 用户彩信内容提

3、交接口 106.3. 飞信平台与MDA平台间的接口 106.3.1. 彩信包实时获取接口 106.4. 飞信平台与彩信网关间的接口 127. 编制历史 12前 言本标准定义了飞信平台与MDA平台之间的接口，使用MDA平台提供的发送彩信的功能为飞信用户提供通过PC客户端向其好友及手机好友发送彩信的功能。本标准规定了飞信PC客户端、飞信平台、MDA平台之间发送彩信相关的接口，是飞信平台发送彩信业务的技术依据。本标准是飞信系列标准之一，该系列标准的结构、名称或预计的名称如下：序号标准编号标准名称1 飞信业务规范2 飞信业务总体技术要求3 飞信业务接口规范-游戏平台接口分册4 飞信业务接口规范-客户端

4、接口SIP-C分册5 飞信业务接口规范-客户端接口XMPP分册6 飞信业务接口规范-位置接口分册7 飞信业务接口规范-彩信接口分册8 飞信业务接口规范-139邮箱接口分册9 飞信业务设备规范-飞信139邮箱互通网关分册10 飞信业务规范-飞信互通业务分册11 飞信业务总体技术要求-飞信互通业务分册12 飞信业务接口规范-飞信平台与互通网关接口分册13 飞信业务接口规范-飞信互通网关与互联网即时消息系统接口分册14 飞信设备规范-飞信互通网关分册15 飞信业务规范-海外运营商接入分册16 飞信业务总体技术要求-海外运营商接入分册17 飞信业务客户端规范-短信客户端分册18 飞信业务客户端规范-手

5、机客户端分册19 飞信业务客户端规范-PC客户端分册本标准需与飞信业务规范、飞信业务总体技术要求配套使用。本标准的附录A为标准性附录。本标准由中移号文件印发。本标准由中国移动通信集团数据部提出，集团公司技术部归口。本标准起草单位：中国移动通信有限公司研究院。本标准主要起草人：李家姿，杨波，刘洪宁，刘舸，齐冬，冯焱，宋阳，宋世乾、武文帅、张卫斌。1. 范围本标准规定了飞信PC客户端、飞信平台、MDA平台之间的接口，供中国移动内部和飞信、MDA运营方及开发方共同使用，适用于各方在开发运营基于MDA平台的飞信彩信业务时遵循。2. 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是

6、注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。表2-1 规范性引用文件序号标准编号标准名称发布单位1飞信业务规范 4.0.0中国移动通信集团公司2飞信总体技术要求 4.0.0中国移动通信集团公司3中国移动多媒体消息接口规范v1.1.0(支持TD-SCDMA)中国移动通信集团公司3. 术语、定义和缩略语下列术语、定义和缩略语适用于本标准：3.1. 术语、定义表3-1 术语、定义词语解释SIDFetion ID，是飞信用户的飞信号。与用户的手机号码

7、之间有对应关系。3.2. 缩略语表3-2 缩略语缩略语英文全称中文含义MDAMobile Desk AssistantMDA是中国移动的一款集短信、彩信、联系人管理、话费查询等强大功能于一体的业务平台4. 业务概述4.1. 业务特征飞信用户可以通过飞信PC客户端向其联系人（好友及手机好友）发送彩信，彩信发送到接收者的手机上。飞信平台对用户下发彩信的频度及数量进行限制，当达到限额后，用户再次发送彩信，客户端会给出提示。彩信下发采用“12520+手机号”或“12520+飞信号”的形式显示主叫号码，如果发送方向接收方公开了手机号，则接收方显示的发送方号码为“12520+发送方手机号”；否则，显示的发

8、送方号码为“12520+发送方飞信号”。平台自动在发送方撰写的彩信内容之前增加如下提示文字“飞信提醒您：本条彩信您暂时无法用彩信方式回复”，管理员可对此提示语进行编辑。用户可以发送一对一彩信，群发彩信（上限32人），给自己发送彩信。当联系人的飞信在线状态设置为“离线”时，不能向其发送彩信。用户使用PC客户端编辑彩信时，可以添加图片、添加音乐、添加文字，图片和音乐可以从彩信库中选择，也可以从本地上传，用户可以自己撰写文本文字加载到彩信中。彩信内容大小不能超过50KB。彩信编辑完成后可以预览效果。彩信发送后，发送者收到消息已经成功提交到服务器的反馈信息。飞信服务器保存彩信发送记录和彩信发送状态的回

9、执。在彩信编辑页面向用户明示资费说明“飞信彩信为付费业务！彩信发送费用将通过您的手机费收取，详见资费标准”。“资费标准”字样超链接到飞信彩信资费的详细说明页面。4.2. 资费说明飞信用户发送彩信采用按条计费的方式，向发送方收取，0.3元/条。计费点在彩信网关，各省可自行决定是否计入套餐。用户发送彩信产生的费用由归属省收取，不与飞信结算。5. 系统结构5.1. 系统结构图图5-1 飞信与MDA间接口结构图5.2. 接口概述飞信PC客户端与飞信平台间有1个接口，为： IF1飞信PC客户端发送彩信接口：客户端通过该接口将彩信发送任务提交到飞信平台。飞信PC客户端与MDA平台间有5个接口，分别为： I

10、F2自写彩信页面加载接口：飞信PC客户端打开彩信编辑页面时调用该接口。 IF3彩信库标签页加载接口：打开飞信PC客户端的彩信库标签页时调用该接口。 IF4从彩信库标签页打开新页面接口：该接口使用户在彩信库标签页中执行搜索或打开彩信分类操作时，内容展示在新页面上。 IF5从彩信库页面选择素材并编辑彩信接口：从彩信库中选中某个素材，直接以该素材编辑彩信时调用该接口。 IF6用户彩信内容提交接口：彩信编辑完成后，MDA平台将彩信打包后的彩信内容ID通知给飞信PC客户端时调用该接口。飞信平台与MDA平台间有1个接口，分别为： IF7彩信包实时同步接口：飞信平台通过该接口实时获取彩信包，接口采用HTTP

11、+XML的形式实现。飞信平台与彩信网关间有2个接口，分别为： IF8飞信平台发送彩信接口：飞信平台通过该接口将彩信发送到彩信网关。 IF9彩信投递状态报告回执接口：彩信网关通过该接口将彩信的状态报告回复给飞信平台。5.3. 接口安全性要求5.3.1. 飞信PC客户端发送彩信的安全机制用户使用飞信发送彩信时需要首先登录飞信PC客户端，发送彩信功能与飞信PC客户端的安全控制模式一致。5.3.2. 自写彩信页面加载的安全机制用户打开飞信PC客户端的彩信编辑页面时，客户端弹出相应的自写彩信窗口，内嵌自写彩信web页面，地址为 XXX&nick=NNN。其中，参数c是飞信平台为每个飞信用户分配的访问MD

12、A彩信服务的credential,对应于域。参数nick为用户的昵称，采用url-encoding。5.3.3. 彩信内容ID及彩信内容的安全机制彩信内容ID采用GUID保证唯一性，只能在一个彩信发送任务中使用，在以后发送中使用此GUID的请求都是无效请求。对于由MDA平台提供素材的短信，飞信PC客户端在将彩信内容提交给MDA平台打包后，MDA平台将彩信内容ID和彩信内容的MD5校验值返回给客户端。飞信平台可通过彩信内容ID从MDA平台获取彩信包，并可通过彩信内容的MD5校验值对彩信内容进行校验，检验彩信包是否被篡改。对于由飞信平台提供素材的短信，飞信PC客户端直接将彩信内容提交给飞信平台，由

13、飞信平台生成彩信内容ID。5.3.4. 通信安全机制飞信平台与MDA平台之间的网络层协议使用HTTPS机制通信，以保证系统和用户数据的安全性。同时，飞信平台和MDA平台各自将对方的IP地址和端口号加入访问白名单，只有在白名单内的服务器才能相互访问。5.4. 彩信发送机制5.4.1. 彩信内容ID的分配原则用户首先在飞信PC客户端编辑彩信，按照彩信内容提供者的不同分为2种情况： 如果彩信内容使用了MDA平台提供的素材，则在完成彩信编辑后，将彩信内容提交到MDA平台打包，由MDA平台分配彩信内容ID并返回给PC客户端； 如果彩信内容使用了飞信平台提供的素材，则客户端将彩信内容提交给飞信平台后，由飞

14、信平台分配彩信内容ID。彩信内容ID采用GUID保证唯一性，只能在一个彩信发送任务中使用，在此次通信完成后该彩信GUID即失效，在以后发送中使用此GUID的请求都是无效请求。5.4.2. 发送流程图5-2 在MDA编辑界面编辑并发送飞信彩信流程通过飞信PC客户端发送彩信业务的具体流程描述如下：16步为从MDA界面编辑彩信的步骤。（1） 用户打开飞信PC客户端的彩信编辑器；（2） 从MDA平台加载彩信编辑页面；（3） MDA平台返回彩信编辑页面；（4） 用户在飞信PC客户端编辑彩信；（5） 用户上传彩信到MDA平台，MDA平台打包彩信；（6） MDA平台向用户返回一个全球唯一的彩信ID号，并附带

15、一个彩信内容的MD5校验值；714步为发送彩信的步骤。（7） 用户提交彩信发送请求到飞信平台，发送内容为彩信内容或彩信内容ID；（8） 飞信平台对彩信发送方鉴权；（9） 飞信平台记录彩信发送请求；（10） 飞信平台向PC客户端返回消息接收状态应答；（11） 飞信平台根据彩信内容ID号向MDA平台请求获取彩信包；（12） MDA平台将彩信包发送给飞信平台，飞信平台可以通过MD5值来校验彩信内容是否被篡改；（13） 飞信平台向彩信网关发送彩信；（14） 彩信网关返回消息接收状态应答；1516步为接收投递状态报告步骤。（15） 彩信网关向接收方投递彩信后返回彩信投递状态报告；（16） 飞信平台记录彩

16、信投递结果。6. 接口定义6.1. 飞信PC客户端与飞信平台间的接口6.1.1. 飞信PC客户端发送彩信接口飞信PC客户端发送彩信接口接口描述飞信PC客户端通过此接口向飞信平台发送彩信。接口协议SIP-C协议请求消息S Domain SIP-C/2.0F: SIDN: SendMMSI: call-id-valueQ: cseq-value SL: content-length-value 参数说明：节点名称功能类型非空message-id彩信内容IDGUID当source-type-value取值为Fetion时，该字段为空；当source-type-value取值为MDA时，该字段必填mm

17、s-type-value彩信类型String是mms-title彩信标题String否mms-size-value彩信大小,以字节为单位Int是send-date-value即将发送彩信的时间日期,采用北京时间。例如：”2005-9-30 15:30:9”DateTime是mobileno-value发送方的手机号码String是nickename-value发送方的昵称String是sendee-sid-value接收方的SID，必须为发送方好友或者手机好友String是Source-type-value彩信内容来源String是digest-value原始彩信内容的md5摘要String是

18、其中，MMSSubmitMessage结点为中国移动MM7标准格式。应答消息SIP-C/2.0 200 OKI: call-id-valueQ: cseq-value SL: content-length-valueresults参数说明：节点名称功能格式非空message-id彩信IDGUID是failed-user-sid接收失败的用户SIDInt否error-code-value失败的错误原因string否6.2. 飞信PC客户端与MDA平台间的接口6.2.1. 自写彩信页面加载接口自写彩信页面加载接口接口描述用户通过飞信PC客户端的彩信入口选择发送彩信时，飞信客户端弹出相应的自写彩信窗

19、口，内嵌自写彩信web页面。接口协议http接口URL XXX&nick=NNN接口原型飞信客户端的彩信编辑对话框直接内嵌该URL地址表示的页面。参 数 参数c是飞信平台为每个飞信用户分配的访问MDA彩信服务的credential,对应于域。参数nick为用户的昵称，采用url-encoding。返回值返回彩信编辑页面6.2.2. 彩信库标签页加载接口彩信库标签页加载接口接口描述飞信PC客户端的标签页内嵌彩信库标签页面， 当打开该标签页时调用该接口。接口协议http接口URL接口原型飞信客户端的标签页窗口内嵌该URL表示的页面。参 数 无返回值返回彩信库标签页页面6.2.3. 从彩信库标签页打

20、开新页面接口从彩信库标签页打开新页面接口接口描述通过该接口可以从飞信标签页内嵌的彩信库中选择分类或搜索，以打开新页面。接口协议http接口URL彩信库标签页中用户所选彩信素材资源的URL，如对某一分类、某个关键字彩信素材的搜索等。接口原型彩信库标签页中的资源都有一个由MDA平台分配的网络地址，当选择查看该资源时，飞信客户端会弹出一个新的WEB窗口来显示该页面。参数无返回值返回飞信WEB窗口6.2.4. 从彩信库页面中选择素材并编辑彩信接口从彩信库页面中选择素材并编辑彩信接口接口描述通过该接口可以从飞信客户端标签页内嵌的彩信库页面选择素材并打开彩信编辑窗口。接口协议http接口URL XXX&n

21、ick=NNN&picurl=pic&（musicurl=music）接口原型在飞信客户端标签页内嵌的彩信库页面选择素材并打开彩信编辑窗口参 数 用户在彩信库页面选择素材：urlname=mda:/mmsres?type=0&picurl=图片网址（&musicurl=声音网址）;window.navigate(urlname); 飞信客户端标签页窗口捕获该事件，解析出url，并打开自写彩信高级模式页面窗口,内嵌彩信库素材的参数（picurl或musicurl）。返回值返回自写彩信高级模式页面窗口6.2.5. 用户彩信内容提交接口用户彩信内容提交接口接口描述用户编辑彩信完成后，点击发送彩信，编

22、辑页面把彩信ID通知给飞信客户端。接口协议http接口URL XXX&nick=NNN&接口原型用户编辑彩信完成后，点击发送彩信，编辑页面把彩信ID通知给飞信客户端参 数 用户编辑彩信完成后，点击发送彩信，编辑页面会弹出一个窗口事件：urlname=mda:/mmsres?type=1&caption=彩信标题&guid=彩信ID&mmsMD5=彩信包MD5;window.navigate(urlname); 飞信客户端自写彩信窗口捕获该事件，获取彩信ID和彩信包的MD5值，完成彩信发送。MD5校验值是MDA平台根据彩信内容生成的，可用于校验飞信从MDA平台获取的彩信包是否被篡改。返回值返回彩

23、信编辑窗口6.3. 飞信平台与MDA平台间的接口6.3.1. 彩信包实时获取接口彩信包实时获取接口接口描述对用户在MDA平台生成的彩信内容，飞信平台可以使用该接口实时获取该彩信包。接口协议https接口URL请求消息POST /mms/getmmspkg HTTP/1.1Host: Content-Type: text/xmlContent-Length: Content-Length-Value参数解释：父节点名称节点名称节点属性类型描述取值说明Request-根节点commandStringRequest节点的属性CommandGetMMSPackageuidStringMDA平台为飞信平

24、台分配的用户名passwordStringMDA平台为飞信平台分配的密码guidString彩信内容ID飞信平台通过该接口获取彩信内容后，可根据此前从飞信客户端获取到的彩信内容的MD5校验值来检测所取回彩信内容的正确性。应答消息参数解释：父节点名称节点名称节点属性类型描述取值说明response-根节点commandStringRequest节点的属性CommandGetMMSPackageguidString彩信内容ID其中，MMSSubmitMessage结点为中国移动MM7标准格式。6.4. 飞信平台与彩信网关间的接口飞信平台与彩信网关间的接口参考中国移动多媒体消息接口规范v1.1.0(支持TD-SCDMA)3。7. 编制历史版本号更新时间主要内容或重大修改1.0.02009-3-18完成征求意见稿2009-3-24完成内部评审稿2009-3-30根据内部评审的意见修改，形成送审稿2009-6-24根据各部门评审意见修改，改为飞信平台通过直连彩信网关下发彩信2009-7-31完成报批稿