94全网行业应用接口规范Word文档格式.docx
- 文档编号:18943905
- 上传时间:2023-01-02
- 格式:DOCX
- 页数:26
- 大小:90.06KB
94全网行业应用接口规范Word文档格式.docx
《94全网行业应用接口规范Word文档格式.docx》由会员分享,可在线阅读,更多相关《94全网行业应用接口规范Word文档格式.docx(26页珍藏版)》请在冰豆网上搜索。
中国移动通信研究院。
本规范主要起草人:
任鹏、锁磊、封令隽、孙楠、王哲伟、常倩、娄涛、张海泳、杨剑、李晟、赵成东、王颖、刘舸。
1.范围
本规范对全网行业应用和省级行业应用涉及的接口和协议提出规定,主要包括IAGW-A(SMS-A、MMS-A)与IAGW-M之间的接口、IAGW-M与BOSS之间的接口、BOSS和EC/SI之间的接口、IAGW-A(SMS-A、MMS-A)和ISMG、MMSC之间的接口等。
本规范用于在业务开展、招标选型、工程建设、运行维护、设备开发方面为集团公司提供技术依据。
2.规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件,其最新版本适用于本标准。
[1]
QB-D-003-2005
《全网行业应用业务规范》1.0.0
中国移动通信有限公司
[2]
QB-D-004-2005
《全网行业应用总体技术要求》1.0.0
[3]
《行业应用网关设备规范》
[4]
《省行业应用网关开放全网行业应用总体技术要求》1.0.0
[5]
《中国移动通信互联网短信网关接口协议(CMPP)》V3.0.0版本及以上
[6]
《集团业务支撑系统文件接口规范-行业应用网关及行业SI部分》V1.0.4
[7]
《省BOSS与省行业网关接口规范-单行本》V1.2.2
[8]
《中国移动一级BOSS系统接口规范-全网行业应用-SMS业务单行本》
[9]
《行业应用网关总体技术要求-彩信分册》
[10]
《行业应用网关设备规范-彩信分册》
[11]
《中国移动ENUM-DNS接口和设备规范(征求意见稿V1.0.3)(20041009)》
[12]
《中国移动多媒体消息接口规范(讨论稿V1.0.4)》
[13]
《中国移动多媒体消息增值应用网关设备规范》V1.0.4
3.术语、定义和缩略语
下列术语、定义和缩略语适用于本标准:
缩写词
英文解析
中文解析
IAGW
IndustryApplicationGateway
行业应用网关
IAGW-A
IndustryApplicationGatewayAccess
行业应用网关接入模块
IAGW-M
IndustryApplicationGatewayManagement
行业应用网关管理模块(行业应用管理系统)
SMS-A
ShortMessageServiceAgent
短信代理模块
MMS-A
MultimediaMessageServiceAgent
彩信代理模块
EC
EnterpriseCustomer
集团客户
SI
ServiceIntegrator
业务集成商
ISMG
InternetShortMessageGateway
短信息网关
SMSC
ShortMessageServiceCenter
短信息中心
MMSC
MultimediaMessageServiceCenter
彩信中心
SMS
ShortMessageService
短信业务
MMS
MultimediaMessageService
彩信业务
EnumDNS
ElectronicNumberingDomainNameSystem
电子编码域名服务器
BOSS
BusinessOperationSupportSystem
业务运营支撑系统
MS
MobileSubscriber
移动用户
MSC
MobileSwitchCenter
移动交换中心
MO
MobileOriginated
个人用户发起的信息
MT
MobileTerminated
发送给个人用户的信息
SMPP
ShortMessagePointtoPoint
短信息点对点协议
CMPP
ChinaMobilePointtoPoint
中国移动点对点协议
PPS
PrepaidSubscriber
预付费用户
4.系统架构
图4-1全网行业应用业务系统结构图
全网行业应用业务系统包括如下组成部分:
1.集团客户(EC)或者业务集成商(SI)侧行业应用平台(简称“EC/SI平台”)
EC/SI平台接入SMS-A为行业用户提供短信服务、接入MMS-A为行业用户提供彩信服务;
并与BOSS同步黑白名单、签约关系和业务信息等。
2.IAGW-M
IAGW-M对业务进行鉴权控制,如黑白名单、签约关系的合法性判断等。
IAGW-M还与BOSS同步黑白名单、签约关系和业务信息。
3.IAGW-A
IAGW-A为行业应用网关接入模块,目前包括短信行业业务接入模块SMS-A和彩信行业业务接入模块MMS-A。
A)SMS-A接收EC/SI平台发送的MT短信,并将EC/SI发送的短信转发给其它SMS-A或ISMG或短消息中心;
接收其它SMS-A或ISMG或短消息中心发送的MO短信,并将MO短信转发给相应的EC/SI。
SMS-A还需生成正确的短信话单,并提供给BOSS。
B)MMS-A接收EC/SI平台发送的AOMT彩信,并将EC/SI发送的彩信转发给MMSC;
接收MMSC发送的MOAT彩信,并将MMSC发送的彩信转发给相应的EC/SI。
MMS-A还需生成正确的彩信话单,并提供给BOSS。
4.其它SMS-A/ISMG
其它SMS-A/ISMG作为全网行业应用短消息通道,负责将个人用户提交的短信转发给SMS-A,并将SMS-A下发的短信转发给个人用户归属的短消息中心。
5.短消息中心
短消息中心负责将SMS-A下发的短信转发给个人用户;
同时负责将个人用户提交的短信转发给SMS-A。
6.彩信中心(MMSC)
MMSC作为全网行业应用彩信通道,负责将个人用户提交的彩信转发给MMS-A,并将MMS-A下发的彩信下发给个人用户。
7.BOSS
BOSS与IAGW-M、EC/SI平台之间都能同步黑白名单、签约关系和业务信息。
8.EnmDNS
MMS-A与EnmDNS相连完成全网路由查询等功能。
5.接口描述
全网行业应用的各接口关系如图5-1:
图5-1全网行业应用网元接口示意图
1.IF1:
IAGW-M和BOSS的接口,采用HTTP接口和FTP文件接口同步签约关系/黑白名单。
IAGW-M和BOSS通过HTTP接口同步EC/SI信息和EC/SI业务信息。
2.IF2:
SMS-A和BOSS的接口,采用FTP传送计费话单。
3.IF3:
MMS-A和BOSS的接口,采用FTP传送计费话单。
4.IF4:
SMS-A/MMS-A和IAGW-M之间的鉴权接口。
5.IF5:
BOSS和EC/SI的接口
a)采用基于HTTP的接口,单条同步黑白名单和业务签约关系。
b)采用基于FTP的接口,批量同步黑白名单和业务签约关系。
c)采用基于HTTP的接口,同步EC/SI信息和EC/SI业务信息。
6.IF6:
SMS-A和EC/SI的接口,使用标准CMPP2.0及以上版本协议。
7.IF7:
MMS-A和EC/SI的接口,使用MM7协议。
8.IF8:
SMS-A和ISMG/SMS-A的接口,SMS-A以网关方式和各省ISMG/SMS-A建立连接。
使用标准CMPP3.0协议。
9.IF9:
SMS-A和短消息中心的接口,使用标准SMPP协议。
10.IF10:
MMS-A和MMSC的接口,使用MM7协议。
11.IF11:
MMS-A和EnmDNS的接口,该接口应符合《中国移动多媒体信息业务ENUM-DNS接口和设备规范》的要求。
6.接口定义
6.1IAGW-A和IAGW-M之间的接口
6.1.1简介
本节定义IAGW-A和IAGW-M之间的接口。
描述的接口列表如下表所示。
消息ID名称
消息ID取值
消息说明
接入模块与管理模块之间的消息
id_LoginReq
0x00000001
登录请求
id_LoginRsp
0x80000001
登录响应
id_AuthUserReq
0x00000002
鉴权请求
id_AuthUserResp
0x80000002
鉴权响应
id_ShakehandReq
0x00000003
链路测试请求
id_ShakehandRsp
0x80000003
链路测试响应
id_LogoutReq
0x00000004
注销请求
id_LogoutRsp
0x80000004
注销响应
6.1.2协议描述
1.基本数据类型
UnsignedInteger4
无符号整数(4字节)
Integer4
整数(4字节)
integer2
整数(2字节)
integer1
unsignedchar
OctetString
定长字符串,位数不足时,如果左补0则补ASCII表示的零,如果右补0则补二进制的零
C-OctetString
以NULL结尾的String
2.消息结构
项目
说明
MessageHeader
消息头(所有消息公共包头)
MessageBody
消息体
3.消息头格式(MessageHeader)
字段名
字节数
类型
描述
Total_Length
4
UnsignedInteger
消息总长度(含消息头及消息体)
Command_Id
命令或响应类型
Sequence_Id
消息流水号,顺序累加,步长为1,循环使用(一对请求和应答消息的流水号必须相同)
6.1.3接口说明
6.1.3.1登录消息
1.登录请求
Ø
方向:
IAGW-A->
IAGW-M
参数:
属性
Source_Addr
6
源地址,此处为IAGW-A编号。
AuthenticatorSource
16
用于鉴别源地址。
其值通过单向MD5hash计算得出,表示如下:
AuthenticatorSource=
MD5(Source_Addr+9字节的0+sharedsecret+timestamp)
Sharedsecret由中国移动与源地址实体事先商定,timestamp格式为:
MMDDHHMMSS,即月日时分秒,10位。
Version
1
双方协商的版本号(高位4bit表示主版本号,低位4bit表示次版本号)
Timestamp
时间戳的明文,由客户端产生,格式为MMDDHHMMSS,即月日时分秒,10位数字的整型,右对齐。
2.登录响应
IAGW-M->
IAGW-A
Status
状态
0:
正确
1:
消息结构错
2:
非法源地址
3:
认证错
4:
版本太高
5~:
其他错误
Authenticator
认证码,用于鉴别IAGW-A。
Authenticator=MD5(Status+AuthenticatorSource+sharedsecret),Sharedsecret由中国移动与源地址实体事先商定,AuthenticatorSource为源地址实体发送给IAGW-M的对应消息登陆请求中的值。
认证出错时,此项为空。
服务器支持的最高版本号
6.1.3.2鉴权消息
IAGW-A在处理MO或MT短信、彩信时,向行业网关管理模块(IAGW-M)发送鉴权消息,IAGW-M根据鉴权消息的内容进行相应鉴权操作。
1.可选字段定义
IAGW-M需要同时支持SMS-A和MMS-A的鉴权,考虑到扩展性和接口性能,鉴权消息需要支持可选字段。
TLV(TagLengthValue)字段定义:
长度
Tag
Integer2
2
字段的Tag值,能够在本规范中唯一标识该字段。
Length
字段的实际长度。
Value
参见具体的字段定义。
字段的取值。
本规范的TLV类型定义:
TLV字段类型
Tag取值
TMsgFmt
0x0001
短消息内容的编码格式。
取值为4字节的整数。
短信行业业务使用。
TSMSContent
0x0002
短消息内容。
取值为字符串类型,最长为200字节。
TPk_total
0x0003
相同LINK_ID的信息总条数。
TPk_number
0x0004
相同LINK_ID的信息序号,从1开始。
TFeePseudoCode
0x0005
计费用户伪码。
取值为字符串类型,最长为50字节。
TPseudoCode
0x0006
使用业务的用户伪码。
TConnectDeviceID
0x0007
用户归属的短信网关ID。
取值为字符串类型,最长为20字节。
TTextSignEn
0x0008
英文签名信息。
TTextSignZh
0x0009
中文签名信息。
TService_Code
0x0010
服务号码信息。
取值为整数类型,最长为21字节。
2.鉴权请求
消息方向:
IAGW-A->
参数
Send_Address
TDeviceAddr
发送方的地址
Dest_Address
接收方的地址
Msg_Id
25
信息标识
FeeUser_ID
TUserID
计费用户标识,MO时填空,MT时填计费号码
User_ID
使用业务的手机用户标识,MO时填主叫用户手机号码,MT时填目的用户手机号码
AccessNum
21
接入号,对应EC/SI的服务代码
短信MO:
填用户发送短信的目的号码
短信MT:
填EC/SI服务代码,消息中的源地址
彩信MO:
填用户发送彩信的目的号码
彩信MT:
填EC/SI服务代码,消息中的VASID字段
ServiceCode
10
业务代码,业务的标志,是数字、字母和符号的组合
填空
填业务代码
填业务代码,消息中的ServiceCode
LinkedID
20
点播消息的匹配标识符
ServiceType
业务类型:
SMSMO
2:
SMSMT
3:
MMSMO
4:
MMSMT
5~待扩展
FeeType
UnsignedChar
CMPP_SUBMIT消息中的资费类别,保留字段,可不处理。
对“计费用户号码”免费
对“计费用户号码”按条计信息费
对“计费用户号码”按包月收取信息费
对“计费用户号码”的信息费封顶
5:
对“计费用户号码”的收费是由EC/SI实现
Money
Integer
SUBMIT消息中的费率,保留字段,可以不处理。
MO时填空
可选字段定义
MsgFmt
参见TLV字段定义
OperStr的编码格式
OperStr
短消息内容,用于分析用户操作指令。
短信MO时填短信内容,短信MT时不填。
Pk_total
Pk_number
其中:
TDeviceAddr的定义为:
DeviceType
设备类型。
100:
DeviceID
设备编码
TUserID的定义为:
UserIDType
用户ID类型。
手机号标识
伪码标识(保留字段,与CMPP3.0兼容)
UserID
50
用户ID
3.鉴权响应
IAGW-M->
Result
返回码
计费类型:
免费
按条计费
包月计费
费率
FeeUserID
计费用户手机号,MO时填空,MT时填计费号码
使用业务的用户手机号,MO时填主叫用户手机号码,MT时填目的用户手机号码
SendSPUserIDType
传递给SP的用户表示类型
传手机号
传伪码(保留,与CMPP3.0兼容)
OperType
本消息的操作类型。
加入白名单/退出黑名单
退出白名单/加入黑名单
点播MO
透传MO
6:
查询MO
7~待扩展
点播关系的匹配标识符
FeeUserType
计费用户类型。
非智能网用户
智能网神州行
2~待扩展
UserType
使用业务的用户类型。
SE_ID
12
EC/SI企业代码
业务代码,填业务代码,ServiceCode
MsgLevel
优先级。
取值为0~9,0为优先级最低,9为优先级最高。
FeePseudoCode
计费用户伪码,开展伪码业务时使用。
PseudoCode
使用业务的用户伪码,开展伪码业务时使用。
ConnectDeviceID
FeatureStr的编码格式。
FeatureStr
替换后的短信内容。
TextSignEn
参
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 94 行业 应用 接口 规范