94全网行业应用接口规范Word文档格式.docx

1、中国移动通信研究院。本规范主要起草人：任鹏、锁磊、封令隽、孙楠、王哲伟、常倩、娄涛、张海泳、杨剑、李晟、赵成东、王颖、刘舸。1. 范围本规范对全网行业应用和省级行业应用涉及的接口和协议提出规定，主要包括IAGW-A（SMS-A、MMS-A）与IAGW-M之间的接口、IAGW-M与BOSS之间的接口、BOSS和EC/SI之间的接口、IAGW-A（SMS-A、MMS-A）和ISMG、MMSC之间的接口等。本规范用于在业务开展、招标选型、工程建设、运行维护、设备开发方面为集团公司提供技术依据。2. 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修

2、改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。1QB-D-003-2005全网行业应用业务规范1.0.0中国移动通信有限公司2QB-D-004-2005全网行业应用总体技术要求1.0.03行业应用网关设备规范4省行业应用网关开放全网行业应用总体技术要求1.0.05中国移动通信互联网短信网关接口协议（CMPP）V3.0.0版本及以上6集团业务支撑系统文件接口规范行业应用网关及行业SI部分V1.0.47省BOSS与省行业网关接口规范单行本V1.2.28中国移动一级BOSS系统接口

3、规范-全网行业应用-SMS业务单行本9行业应用网关总体技术要求彩信分册10行业应用网关设备规范彩信分册11中国移动ENUM-DNS接口和设备规范（征求意见稿V1.0.3）（20041009） 12中国移动多媒体消息接口规范（讨论稿V1.0.4）13中国移动多媒体消息增值应用网关设备规范V1.0.43. 术语、定义和缩略语下列术语、定义和缩略语适用于本标准：缩写词英文解析中文解析IAGWIndustry Application Gateway行业应用网关IAGW-AIndustry Application Gateway Access行业应用网关接入模块IAGW-MIndustry Applic

4、ation Gateway Management行业应用网关管理模块（行业应用管理系统）SMS-AShort Message Service Agent短信代理模块MMS-AMultimedia Message Service Agent彩信代理模块ECEnterprise Customer集团客户SIService Integrator业务集成商ISMGInternet Short Message Gateway短信息网关SMSCShort Message Service Center短信息中心MMSCMultimedia Message Service Center彩信中心SMSShort

5、 Message Service短信业务MMSMultimedia Message Service彩信业务EnumDNSElectronic Numbering Domain Name System电子编码域名服务器BOSSBusiness Operation Support System业务运营支撑系统MSMobile Subscriber移动用户MSCMobile Switch Center移动交换中心MOMobile Originated个人用户发起的信息MTMobile Terminated发送给个人用户的信息SMPPShort Message Point to Point短信息点对点

6、协议CMPPChina Mobile Point to Point中国移动点对点协议PPSPrepaid Subscriber预付费用户4. 系统架构 图4-1 全网行业应用业务系统结构图全网行业应用业务系统包括如下组成部分：1. 集团客户（EC）或者业务集成商（SI）侧行业应用平台（简称“EC/SI平台”）EC/SI平台接入SMS-A为行业用户提供短信服务、接入MMS-A为行业用户提供彩信服务；并与BOSS同步黑白名单、签约关系和业务信息等。2. IAGW-MIAGW-M对业务进行鉴权控制，如黑白名单、签约关系的合法性判断等。IAGW-M还与BOSS同步黑白名单、签约关系和业务信息。3. I

7、AGW-AIAGW-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还需生成正确的彩信话单，并提供给BOS

8、S。4. 其它SMS-A/ISMG其它SMS-A/ISMG作为全网行业应用短消息通道，负责将个人用户提交的短信转发给SMS-A，并将SMS-A下发的短信转发给个人用户归属的短消息中心。5. 短消息中心短消息中心负责将SMS-A下发的短信转发给个人用户；同时负责将个人用户提交的短信转发给SMS-A。6. 彩信中心（MMSC）MMSC作为全网行业应用彩信通道，负责将个人用户提交的彩信转发给MMS-A，并将MMS-A下发的彩信下发给个人用户。7. BOSSBOSS与IAGW-M、EC/SI平台之间都能同步黑白名单、签约关系和业务信息。8. EnmDNSMMS-A与EnmDNS相连完成全网路由查询等功

9、能。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的接口

10、，批量同步黑白名单和业务签约关系。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的接口，该接口应符合中国移动多媒体信息

11、业务ENUM-DNS接口和设备规范的要求。6. 接口定义6.1 IAGW-A和IAGW-M之间的接口6.1.1 简介本节定义IAGW-A和IAGW-M之间的接口。描述的接口列表如下表所示。消息ID名称消息ID取值消息说明接入模块与管理模块之间的消息id_LoginReq0x00000001登录请求id_LoginRsp0x80000001登录响应id_AuthUserReq0x00000002鉴权请求id_AuthUserResp0x80000002鉴权响应id_ShakehandReq 0x00000003链路测试请求id_ShakehandRsp0x80000003链路测试响应id_Log

12、outReq0x00000004注销请求id_LogoutRsp0x80000004注销响应6.1.2 协议描述1. 基本数据类型Unsigned Integer4无符号整数（4字节）Integer4整数（4字节）integer2整数（2字节）integer1unsigned charOctet String定长字符串，位数不足时，如果左补0则补ASCII表示的零，如果右补0则补二进制的零C-Octet String以NULL结尾的String2. 消息结构项目说明Message Header消息头（所有消息公共包头）Message Body消息体3. 消息头格式（Message Header

13、）字段名字节数类型描述Total_Length 4Unsigned Integer消息总长度（含消息头及消息体）Command_Id命令或响应类型Sequence_Id消息流水号,顺序累加,步长为1,循环使用（一对请求和应答消息的流水号必须相同）6.1.3 接口说明6.1.3.1 登录消息1. 登录请求 方向： IAGW -A - IAGW-M 参数：属性Source_Addr 6源地址，此处为IAGW-A编号。AuthenticatorSource16用于鉴别源地址。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorSource =MD5（Source_Addr+9

14、字节的0 +shared secret+timestamp）Shared secret 由中国移动与源地址实体事先商定，timestamp格式为：MMDDHHMMSS，即月日时分秒，10位。Version1双方协商的版本号（高位4bit表示主版本号,低位4bit表示次版本号）Timestamp时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐 。2. 登录响应IAGW-M - IAGW-AStatus状态0：正确1：消息结构错 2：非法源地址 3：认证错 4：版本太高 5 ：其他错误Authenticator认证码，用于鉴别IAGW-A。Authen

15、ticator =MD5（Status+AuthenticatorSource+shared secret），Shared secret 由中国移动与源地址实体事先商定，AuthenticatorSource为源地址实体发送给IAGW-M的对应消息登陆请求中的值。 认证出错时，此项为空。服务器支持的最高版本号6.1.3.2 鉴权消息IAGW-A在处理MO或MT短信、彩信时，向行业网关管理模块（IAGW-M）发送鉴权消息，IAGW-M根据鉴权消息的内容进行相应鉴权操作。1. 可选字段定义IAGW-M需要同时支持SMS-A和MMS-A的鉴权，考虑到扩展性和接口性能，鉴权消息需要支持可选字段。TLV

16、（Tag Length Value）字段定义：长度TagInteger22字段的Tag值，能够在本规范中唯一标识该字段。Length字段的实际长度。Value参见具体的字段定义。字段的取值。本规范的TLV类型定义：TLV字段类型Tag取值TMsgFmt0x0001短消息内容的编码格式。取值为4字节的整数。短信行业业务使用。TSMSContent0x0002短消息内容。取值为字符串类型，最长为200字节。TPk_total0x0003相同LINK_ID的信息总条数。TPk_number0x0004相同LINK_ID的信息序号，从1开始。TFeePseudoCode0x0005计费用户伪码。取值为

17、字符串类型，最长为50字节。TPseudoCode0x0006使用业务的用户伪码。TConnectDeviceID0x0007用户归属的短信网关ID。取值为字符串类型，最长为20字节。TTextSignEn0x0008英文签名信息。TTextSignZh0x0009中文签名信息。TService_Code0x0010服务号码信息。取值为整数类型，最长为21字节。2. 鉴权请求 消息方向：IAGW-A- 参数Send_AddressTDeviceAddr发送方的地址Dest_Address接收方的地址Msg_Id25信息标识FeeUser_IDTUserID计费用户标识，MO时填空，MT时填计费

18、号码User_ID使用业务的手机用户标识，MO时填主叫用户手机号码，MT时填目的用户手机号码AccessNum21接入号，对应EC/SI的服务代码短信MO：填用户发送短信的目的号码短信MT：填EC/SI服务代码，消息中的源地址彩信MO：填用户发送彩信的目的号码彩信MT：填EC/SI服务代码，消息中的VASID字段ServiceCode10业务代码，业务的标志，是数字、字母和符号的组合填空填业务代码填业务代码，消息中的ServiceCodeLinkedID20点播消息的匹配标识符ServiceType业务类型：SMSMO2：SMSMT3：MMSMO4：MMSMT5 待扩展FeeTypeUnsig

19、ned CharCMPP_SUBMIT消息中的资费类别，保留字段，可不处理。对“计费用户号码”免费对“计费用户号码”按条计信息费对“计费用户号码”按包月收取信息费对“计费用户号码”的信息费封顶5：对“计费用户号码”的收费是由EC/SI实现MoneyIntegerSUBMIT消息中的费率，保留字段，可以不处理。MO时填空可选字段定义MsgFmt参见TLV字段定义OperStr的编码格式OperStr短消息内容，用于分析用户操作指令。短信MO时填短信内容，短信MT时不填。Pk_totalPk_number其中：TDeviceAddr的定义为：DeviceType设备类型。100：DeviceID设

20、备编码TUserID的定义为：UserIDType用户ID类型。手机号标识伪码标识（保留字段，与CMPP3.0兼容）UserID50用户ID3. 鉴权响应IAGW-M-Result返回码计费类型：免费按条计费包月计费费率FeeUserID计费用户手机号，MO时填空，MT时填计费号码使用业务的用户手机号，MO时填主叫用户手机号码，MT时填目的用户手机号码SendSPUserIDType传递给SP的用户表示类型传手机号传伪码（保留，与CMPP3.0兼容）OperType本消息的操作类型。加入白名单/退出黑名单退出白名单/加入黑名单点播MO透传MO6：查询MO7 待扩展点播关系的匹配标识符FeeUserType计费用户类型。非智能网用户智能网神州行2 待扩展UserType使用业务的用户类型。SE_ID12EC/SI企业代码业务代码，填业务代码，ServiceCodeMsgLevel优先级。取值为09，0为优先级最低，9为优先级 最高。FeePseudoCode计费用户伪码，开展伪码业务时使用。PseudoCode使用业务的用户伪码，开展伪码业务时使用。ConnectDeviceIDFeatureStr的编码格式。FeatureStr替换后的短信内容。TextSignEn参