中国移动飞信平台飞信业务接口规范 彩信接口分册 100报批稿.docx
《中国移动飞信平台飞信业务接口规范 彩信接口分册 100报批稿.docx》由会员分享，可在线阅读，更多相关《中国移动飞信平台飞信业务接口规范 彩信接口分册 100报批稿.docx（22页珍藏版）》请在冰豆网上搜索。
中国移动飞信平台飞信业务接口规范彩信接口分册100报批稿
中国移动通信企业标准
QB-╳╳-╳╳╳-╳╳╳╳
飞信业务接口规范
彩信接口分册
FetionInterfaceSpecificationforMultimediaMessageService
版本号：
1.0.0
╳╳╳╳-╳╳-╳╳实施
╳╳╳╳-╳╳-╳╳发布
中国移动通信集团公司发布
目录
前言II
1.范围1
2.规范性引用文件1
3.术语、定义和缩略语1
3.1.术语、定义1
3.2.缩略语1
4.业务概述2
4.1.业务特征2
4.2.资费说明2
5.系统结构2
5.1.系统结构图2
5.2.接口概述3
5.3.接口安全性要求3
5.3.1.飞信PC客户端发送彩信的安全机制3
5.3.2.自写彩信页面加载的安全机制4
5.3.3.彩信内容ID及彩信内容的安全机制4
5.3.4.通信安全机制4
5.4.彩信发送机制4
5.4.1.彩信内容ID的分配原则4
5.4.2.发送流程5
6.接口定义6
6.1.飞信PC客户端与飞信平台间的接口6
6.1.1.飞信PC客户端发送彩信接口6
6.2.飞信PC客户端与MDA平台间的接口8
6.2.1.自写彩信页面加载接口8
6.2.2.彩信库标签页加载接口8
6.2.3.从彩信库标签页打开新页面接口9
6.2.4.从彩信库页面中选择素材并编辑彩信接口9
6.2.5.用户彩信内容提交接口10
6.3.飞信平台与MDA平台间的接口10
6.3.1.彩信包实时获取接口10
6.4.飞信平台与彩信网关间的接口12
7.编制历史12
前言
本标准定义了飞信平台与MDA平台之间的接口，使用MDA平台提供的发送彩信的功能为飞信用户提供通过PC客户端向其好友及手机好友发送彩信的功能。
本标准规定了飞信PC客户端、飞信平台、MDA平台之间发送彩信相关的接口，是飞信平台发送彩信业务的技术依据。
本标准是飞信系列标准之一，该系列标准的结构、名称或预计的名称如下：
序号
标准编号
标准名称
1
飞信业务规范
2
飞信业务总体技术要求
3
飞信业务接口规范-游戏平台接口分册
4
飞信业务接口规范-客户端接口SIP-C分册
5
飞信业务接口规范-客户端接口XMPP分册
6
飞信业务接口规范-位置接口分册
7
飞信业务接口规范-彩信接口分册
8
飞信业务接口规范-139邮箱接口分册
9
飞信业务设备规范-飞信139邮箱互通网关分册
10
飞信业务规范-飞信互通业务分册
11
飞信业务总体技术要求-飞信互通业务分册
12
飞信业务接口规范-飞信平台与互通网关接口分册
13
飞信业务接口规范-飞信互通网关与互联网即时消息系统接口分册
14
飞信设备规范-飞信互通网关分册
15
飞信业务规范-海外运营商接入分册
16
飞信业务总体技术要求-海外运营商接入分册
17
飞信业务客户端规范-短信客户端分册
18
飞信业务客户端规范-手机客户端分册
19
飞信业务客户端规范-PC客户端分册
本标准需与《飞信业务规范》、《飞信业务总体技术要求》配套使用。
本标准的附录A为标准性附录。
本标准由中移号文件印发。
本标准由中国移动通信集团数据部提出，集团公司技术部归口。
本标准起草单位：
中国移动通信有限公司研究院。
本标准主要起草人：
李家姿，杨波，刘洪宁，刘舸，齐冬，冯焱，宋阳，宋世乾、武文帅、张卫斌。
1.范围
本标准规定了飞信PC客户端、飞信平台、MDA平台之间的接口，供中国移动内部和飞信、MDA运营方及开发方共同使用，适用于各方在开发运营基于MDA平台的飞信彩信业务时遵循。
2.规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件，其最新版本适用于本标准。
表2-1规范性引用文件
序号
标准编号
标准名称
发布单位
[1]
飞信业务规范4.0.0
中国移动通信集团公司
[2]
飞信总体技术要求4.0.0
中国移动通信集团公司
[3]
中国移动多媒体消息接口规范v1.1.0（支持TD-SCDMA）
中国移动通信集团公司
3.术语、定义和缩略语
下列术语、定义和缩略语适用于本标准：
3.1.术语、定义
表3-1术语、定义
词语
解释
SID
FetionID，是飞信用户的飞信号。
与用户的手机号码之间有对应关系。
3.2.缩略语
表3-2缩略语
缩略语
英文全称
中文含义
MDA
MobileDeskAssistant
MDA是中国移动的一款集短信、彩信、联系人管理、话费查询等强大功能于一体的业务平台
4.业务概述
4.1.业务特征
飞信用户可以通过飞信PC客户端向其联系人（好友及手机好友）发送彩信，彩信发送到接收者的手机上。
飞信平台对用户下发彩信的频度及数量进行限制，当达到限额后，用户再次发送彩信，客户端会给出提示。
彩信下发采用“12520+手机号”或“12520+飞信号”的形式显示主叫号码，如果发送方向接收方公开了手机号，则接收方显示的发送方号码为“12520+发送方手机号”；否则，显示的发送方号码为“12520+发送方飞信号”。
平台自动在发送方撰写的彩信内容之前增加如下提示文字“飞信提醒您：
本条彩信您暂时无法用彩信方式回复”，管理员可对此提示语进行编辑。
用户可以发送一对一彩信，群发彩信（上限32人），给自己发送彩信。
当联系人的飞信在线状态设置为“离线”时，不能向其发送彩信。
用户使用PC客户端编辑彩信时，可以添加图片、添加音乐、添加文字，图片和音乐可以从彩信库中选择，也可以从本地上传，用户可以自己撰写文本文字加载到彩信中。
彩信内容大小不能超过50KB。
彩信编辑完成后可以预览效果。
彩信发送后，发送者收到消息已经成功提交到服务器的反馈信息。
飞信服务器保存彩信发送记录和彩信发送状态的回执。
在彩信编辑页面向用户明示资费说明“飞信彩信为付费业务！
彩信发送费用将通过您的手机费收取，详见资费标准”。
“资费标准”字样超链接到飞信彩信资费的详细说明页面。
4.2.资费说明
飞信用户发送彩信采用按条计费的方式，向发送方收取，0.3元/条。
计费点在彩信网关，各省可自行决定是否计入套餐。
用户发送彩信产生的费用由归属省收取，不与飞信结算。
5.系统结构
5.1.系统结构图
图5-1飞信与MDA间接口结构图
5.2.接口概述
飞信PC客户端与飞信平台间有1个接口，为：
●IF1飞信PC客户端发送彩信接口：
客户端通过该接口将彩信发送任务提交到飞信平台。
飞信PC客户端与MDA平台间有5个接口，分别为：
●IF2自写彩信页面加载接口：
飞信PC客户端打开彩信编辑页面时调用该接口。
●IF3彩信库标签页加载接口：
打开飞信PC客户端的彩信库标签页时调用该接口。
●IF4从彩信库标签页打开新页面接口：
该接口使用户在彩信库标签页中执行搜索或打开彩信分类操作时，内容展示在新页面上。
●IF5从彩信库页面选择素材并编辑彩信接口：
从彩信库中选中某个素材，直接以该素材编辑彩信时调用该接口。
●IF6用户彩信内容提交接口：
彩信编辑完成后，MDA平台将彩信打包后的彩信内容ID通知给飞信PC客户端时调用该接口。
飞信平台与MDA平台间有1个接口，分别为：
●IF7彩信包实时同步接口：
飞信平台通过该接口实时获取彩信包，接口采用HTTP+XML的形式实现。
飞信平台与彩信网关间有2个接口，分别为：
●IF8飞信平台发送彩信接口：
飞信平台通过该接口将彩信发送到彩信网关。
●IF9彩信投递状态报告回执接口：
彩信网关通过该接口将彩信的状态报告回复给飞信平台。
5.3.接口安全性要求
5.3.1.飞信PC客户端发送彩信的安全机制
用户使用飞信发送彩信时需要首先登录飞信PC客户端，发送彩信功能与飞信PC客户端的安全控制模式一致。
5.3.2.自写彩信页面加载的安全机制
用户打开飞信PC客户端的彩信编辑页面时，客户端弹出相应的自写彩信窗口，内嵌自写彩信web页面，地址为XXX&nick=NNN。
其中，参数c是飞信平台为每个飞信用户分配的访问MDA彩信服务的credential,对应于域。
参数nick为用户的昵称，采用url-encoding。
5.3.3.彩信内容ID及彩信内容的安全机制
彩信内容ID采用GUID保证唯一性，只能在一个彩信发送任务中使用，在以后发送中使用此GUID的请求都是无效请求。
对于由MDA平台提供素材的短信，飞信PC客户端在将彩信内容提交给MDA平台打包后，MDA平台将彩信内容ID和彩信内容的MD5校验值返回给客户端。
飞信平台可通过彩信内容ID从MDA平台获取彩信包，并可通过彩信内容的MD5校验值对彩信内容进行校验，检验彩信包是否被篡改。
对于由飞信平台提供素材的短信，飞信PC客户端直接将彩信内容提交给飞信平台，由飞信平台生成彩信内容ID。
5.3.4.通信安全机制
飞信平台与MDA平台之间的网络层协议使用HTTPS机制通信，以保证系统和用户数据的安全性。
同时，飞信平台和MDA平台各自将对方的IP地址和端口号加入访问白名单，只有在白名单内的服务器才能相互访问。
5.4.彩信发送机制
5.4.1.彩信内容ID的分配原则
用户首先在飞信PC客户端编辑彩信，按照彩信内容提供者的不同分为2种情况：
●如果彩信内容使用了MDA平台提供的素材，则在完成彩信编辑后，将彩信内容提交到MDA平台打包，由MDA平台分配彩信内容ID并返回给PC客户端；
●如果彩信内容使用了飞信平台提供的素材，则客户端将彩信内容提交给飞信平台后，由飞信平台分配彩信内容ID。
彩信内容ID采用GUID保证唯一性，只能在一个彩信发送任务中使用，在此次通信完成后该彩信GUID即失效，在以后发送中使用此GUID的请求都是无效请求。
5.4.2.发送流程
图5-2在MDA编辑界面编辑并发送飞信彩信流程
通过飞信PC客户端发送彩信业务的具体流程描述如下：
1~6步为从MDA界面编辑彩信的步骤。
（1）用户打开飞信PC客户端的彩信编辑器；
（2）从MDA平台加载彩信编辑页面；
（3）MDA平台返回彩信编辑页面；
（4）用户在飞信PC客户端编辑彩信；
（5）用户上传彩信到MDA平台，MDA平台打包彩信；
（6）MDA平台向用户返回一个全球唯一的彩信ID号，并附带一个彩信内容的MD5校验值；
7~14步为发送彩信的步骤。
（7）用户提交彩信发送请求到飞信平台，发送内容为彩信内容或彩信内容ID；
（8）飞信平台对彩信发送方鉴权；
（9）飞信平台记录彩信发送请求；
（10）飞信平台向PC客户端返回消息接收状态应答；
（11）飞信平台根据彩信内容ID号向MDA平台请求获取彩信包；
（12）MDA平台将彩信包发送给飞信平台，飞信平台可以通过MD5值来校验彩信内容是否被篡改；
（13）飞信平台向彩信网关发送彩信；
（14）彩信网关返回消息接收状态应答；
15~16步为接收投递状态报告步骤。
（15）彩信网关向接收方投递彩信后返回彩信投递状态报告；
（16）飞信平台记录彩信投递结果。
6.接口定义
6.1.飞信PC客户端与飞信平台间的接口
6.1.1.飞信PC客户端发送彩信接口
飞信PC客户端发送彩信接口
接口描述
飞信PC客户端通过此接口向飞信平台发送彩信。
接口协议
SIP-C协议
请求消息
SDomainSIP-C/2.0
F:
SID
N:
SendMMS
I:
call-id-value
Q:
cseq-valueS
L:
content-length-value
size=”mms-size-value”send-date=“send-date-value”digest=”digest-value”source-type=”source-type-value”>
……
…
参数说明：
节点名称
功能
类型
非空
message-id
彩信内容ID
GUID
当source-type-value取值为Fetion时，该字段为空；当source-type-value取值为MDA时，该字段必填
mms-type-value
彩信类型
String
是
mms-title
彩信标题
String
否
mms-size-value
彩信大小,以字节为单位
Int
是
send-date-value
即将发送彩信的时间日期,采用北京时间。
例如：
”2005-9-3015:
30:
9”
DateTime
是
mobileno-value
发送方的手机号码
String
是
nickename-value
发送方的昵称
String
是
sendee-sid-value
接收方的SID，必须为发送方好友或者手机好友
String
是
Source-type-value
彩信内容来源
String
是
digest-value
原始彩信内容的md5摘要
String
是
其中，MMSSubmitMessage结点为中国移动MM7标准格式。
应答消息
SIP-C/2.0200OK
I:
call-id-value
Q:
cseq-valueS
L:
content-length-value
…
参数说明：
节点名称
功能
格式
非空
message-id
彩信ID
GUID
是
failed-user-sid
接收失败的用户SID
Int
否
error-code-value
失败的错误原因
string
否
6.2.飞信PC客户端与MDA平台间的接口
6.2.1.自写彩信页面加载接口
自写彩信页面加载接口
接口描述
用户通过飞信PC客户端的彩信入口选择发送彩信时，飞信客户端弹出相应的自写彩信窗口，内嵌自写彩信web页面。
接口协议
http
接口URL
XXX&nick=NNN
接口原型
飞信客户端的彩信编辑对话框直接内嵌该URL地址表示的页面。
参数
参数c是飞信平台为每个飞信用户分配的访问MDA彩信服务的credential,对应于域。
参数nick为用户的昵称，采用url-encoding。
返回值
返回彩信编辑页面
6.2.2.彩信库标签页加载接口
彩信库标签页加载接口
接口描述
飞信PC客户端的标签页内嵌彩信库标签页面，当打开该标签页时调用该接口。
接口协议
http
接口URL
接口原型
飞信客户端的标签页窗口内嵌该URL表示的页面。
参数
无
返回值
返回彩信库标签页页面
6.2.3.从彩信库标签页打开新页面接口
从彩信库标签页打开新页面接口
接口描述
通过该接口可以从飞信标签页内嵌的彩信库中选择分类或搜索，以打开新页面。
接口协议
http
接口URL
彩信库标签页中用户所选彩信素材资源的URL，如对某一分类、某个关键字彩信素材的搜索等。
接口原型
彩信库标签页中的资源都有一个由MDA平台分配的网络地址，当选择查看该资源时，飞信客户端会弹出一个新的WEB窗口来显示该页面。
参数
无
返回值
返回飞信WEB窗口
6.2.4.从彩信库页面中选择素材并编辑彩信接口
从彩信库页面中选择素材并编辑彩信接口
接口描述
通过该接口可以从飞信客户端标签页内嵌的彩信库页面选择素材并打开彩信编辑窗口。
接口协议
http
接口URL
XXX&nick=NNN
&picurl=pic&（musicurl=music）
接口原型
在飞信客户端标签页内嵌的彩信库页面选择素材并打开彩信编辑窗口
参数
用户在彩信库页面选择素材：
urlname=mda:
//mmsres?
type=0&picurl=图片网址（&musicurl=声音网址）;
window.navigate（urlname）;
飞信客户端标签页窗口捕获该事件，解析出url，并打开自写彩信高级模式页面窗口,内嵌彩信库素材的参数（picurl或musicurl）。
返回值
返回自写彩信高级模式页面窗口
6.2.5.用户彩信内容提交接口
用户彩信内容提交接口
接口描述
用户编辑彩信完成后，点击发送彩信，编辑页面把彩信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平台获取的彩信包是否被篡改。
返回值
返回彩信编辑窗口
6.3.飞信平台与MDA平台间的接口
6.3.1.彩信包实时获取接口
彩信包实时获取接口
接口描述
对用户在MDA平台生成的彩信内容，飞信平台可以使用该接口实时获取该彩信包。
接口协议
https
接口URL
请求消息
POST/mms/getmmspkgHTTP/1.1
Host:
Content-Type:
text/xml
Content-Length:
Content-Length-Value
xmlversion="1.0"encoding="UTF-8"?
>
参数解释：
父节点
名称
节点
名称
节点
属性
类型
描述
取值说明
Request
-
根节点
command
String
Request节点的属性Command
GetMMSPackage
uid
String
MDA平台为飞信平台分配的用户名
password
String
MDA平台为飞信平台分配的密码
guid
String
彩信内容ID
飞信平台通过该接口获取彩信内容后，可根据此前从飞信客户端获取到的彩信内容的MD5校验值来检测所取回彩信内容的正确性。
应答消息
xmlversion="1.0"encoding="UTF-8"?
>
…
参数解释：
父节点
名称
节点
名称
节点
属性
类型
描述
取值说明
response
-
根节点
command
String
Request节点的属性Command
GetMMSPackage
guid
String
彩信内容ID
其中，MMSSubmitMessage结点为中国移动MM7标准格式。
6.4.飞信平台与彩信网关间的接口
飞信平台与彩信网关间的接口参考《中国移动多媒体消息接口规范v1.1.0（支持TD-SCDMA）》[3]。
7.编制历史
版本号
更新时间
主要内容或重大修改
1.0.0
2009-3-18
完成征求意见稿
2009-3-24
完成内部评审稿
2009-3-30
根据内部评审的意见修改，形成送审稿
2009-6-24
根据各部门评审意见修改，改为飞信平台通过直连彩信网关下发彩信
2009-7-31
完成报批稿
升级会员 