行业应用网关接口规范v300

行业应用网关接口规范v300 中国移动通信企业 QB-D-035-2008 行业应用网关接口规范 Interface Spec. for Industry Application Gateway 版本号:3.0.0 2008-5-12发布 2008-5-12实施 中国移动通信有限公司 发布 QB-D-035-2008 目 录 1. 范围.......................................................................................................................... 1 2. 规范性引用文件 ........................................................................................................ 1 3. 术语、定义和缩略语 ................................................................................................. 2 4. 系统架构................................................................................................................... 35. 接口描述................................................................................................................... 4 6. 接口定义................................................................................................................... 6 6.1IAGW-A和IAGW-M之间的接口 .......................................................................... 6 6.1.1简介........................................................................................................... 6 6.1.2协议描述.................................................................................................... 6 6.1.3协议栈 ....................................................................................................... 7 6.1.4通信方式.................................................................................................... 7 6.1.5接口说明.................................................................................................... 8 6.1.6返回码定义 .............................................................................................. 15 6.2IAGW-M和BOSS之间的接口 ............................................................................ 17 6.3SMS-A和周边部件的接口................................................................................... 17 6.3.1SMS-A和IAGW-M的接口........................................................................ 17 6.3.2SMS-A和BOSS之间的接口...................................................................... 17 6.3.3SMS-A和ISMG/SMS-A之间的接口 .......................................................... 17 6.3.4SMS-A和EC/SI之间的接口...................................................................... 17 6.3.5SMS-A和短消息中心之间的接口............................................................... 17 6.4MMS-A和周边部件的接口 ................................................................................. 17 6.4.1MMS-A和IAGW-M的接口....................................................................... 17 6.4.2MMS-A和BOSS之间的接口 .................................................................... 17 6.4.3MMS-A和MMSC之间的接口................................................................... 18 6.4.4MMS-A和EC/SI之间的接口..................................................................... 18 6.4.5MMS-A和EnmDNS之间的接口 ............................................................... 18 6.5EC/SI和BOSS之间的接口 ................................................................................. 18 7. 可选字段定义.......................................................................................................... 18 8. 编制历史................................................................................................................. 19 I QB-D-035-2008 前 言 本标准对中国移动开展全网行业应用和省级行业应用涉及的接口和协议规范进行了规定，包括IAGW-A(SMS-A、MMS-A)、IAGW-M、ISMG、MMSC、BOSS、EC/SI等网元之间的接口和协议。本文是中国移动开展行业应用，在网络的设备引进、网络规划、工程设计、网络运行、管理和维护等方面的技术依据。现阶段，全网行业应用采用一点接入一点结算的方式为全网集团客户(EC)/合作伙伴(SI)提供业务。根据业务的需求和发展的规模，各省也可以开展省级行业应用业务(只面向省内用户)，由各省分别负责。本标准同时适用于全网行业应用业务和省级行业应用业务。全网行业应用业务和省级行业应用业务在现阶段只考虑SMS和MMS的接入和管理，以后根据业务发展的需要再逐渐增加WAP、USSD等的接入和管理。本版本仅包含对SMS和MMS接入和管理的定义。 本规范主要包括以下几方面的内容，系统架构、接口描述、接口定义等。 本标准由中移有限技〔2008〕61号印发。 本标准中国移动通信有限公司技术部提出并归口。 本标准由标准归口部门负责解释。 本标准起草单位:中国移动通信研究院。 本标准主要起草人:杨剑、肖青、李晟、赵立君、赵辉、王颖、任志强、朱凯、易武、黄威、卢伟。 II QB-D-035-2008 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] 《行业应用网关设备规范——M中国移动通信有限公司 模块分册》 [4] 《行业应用网关设备规范——中国移动通信有限公司 短信&WAPPush分册》 [5] 《行业应用网关设备规范——中国移动通信有限公司 彩信分册》 [6] 《省行业应用网关开放全网行中国移动通信有限公司 业应用总体技术要求》1.0.0 [7] 《行业应用网关总体技术要求中国移动通信有限公司 ——M模块分册》 [8] 《行业应用网关总体技术要求中国移动通信有限公司 ——短信分册》 [9] 《行业应用网关总体技术要求中国移动通信有限公司 ——WAPPush分册》 [10] 《行业应用网关总体技术要求中国移动通信有限公司 ——彩信分册》 [11] 《中国移动通信互联网短信网中国移动通信有限公司 关接口协议(CMPP)》V3.0.0 1 QB-D-035-2008 版本及以上 [12] 《集团业务支撑系统文件接口中国移动通信有限公司 规范,行业应用网关及行业SI 部分》V1.0.4 [13] 《BBOSS与全网网关接口规范中国移动通信有限公司 单行本》 《省BOSS与行业网关接口规范》 中国移动通信有限公司 [14] 《中国移动一级BOSS系统接口中国移动通信有限公司 [15] 规范-全网行业应用-SMS业务单 行本》 《中国移动ENUM-DNS接口和中国移动通信有限公司 [16] 设备规范(征求意见稿V1.0.3) (20041009) 》 《中国移动多媒体消息接口规中国移动通信有限公司 [17] 范(讨论稿V1.0.4)》 [18] 《中国移动多媒体消息增值应中国移动通信有限公司 用网关设备规范》V1.0.4 3. 术语、定义和缩略语 下列术语、定义和缩略语适用于本标准: 缩写词 英文解析 中文解析 IAGW Industry Application Gateway 行业应用网关 IAGW-A Industry Application Gateway Access 行业应用网关接入模块 行业应用网关管理模块(行IAGW-M Industry Application Gateway Management 业应用) SMS-A Short Message Service Agent 短信代理模块 MMS-A Multimedia Message Service Agent 彩信代理模块 EC Enterprise Customer 集团客户 SI Service Integrator 业务集成商 短信息网关 ISMG Internet Short Message Gateway 短信息中心 SMSC Short Message Service Center 彩信中心 MMSC Multimedia Message Service Center 短信业务 SMS Short Message Service 彩信业务 MMS Multimedia Message Service 电子编码域名服务器 EnumDNS Electronic Numbering Domain Name System 业务运营支撑系统 BOSS Business Operation Support System 移动用户 MS Mobile Subscriber 2 QB-D-035-2008 移动交换中心 MSC Mobile Switch Center 个人用户发起的信息 MO Mobile Originated 发送给个人用户的信息 MT Mobile Terminated 短信息点对点协议 SMPP Short Message Point to Point 中国移动点对点协议 CMPP China Mobile Point to Point 预付费用户 PPS Prepaid Subscriber Mobile Agent Server 移动代理服务器 MAS Application Data Center 应用数据中心 ADC 4. 系统架构 图4-1 全网行业应用业务系统结构图 全网行业应用业务系统包括如下组成部分: 1. 集团客户(EC)或者业务集成商(SI)侧行业应用平台(简称“EC/SI平台”) EC/SI平台接入SMS-A为行业用户提供短信服务、接入MMS-A为行业用户提供彩信服务;并与BOSS同步黑白名单、签约关系和业务信息等。 3 QB-D-035-2008 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 其它SMS-A作为全网行业应用短消息通道，负责将个人用户提交的短信转发给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: 4 QB-D-035-2008 图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和其它SMS-A的接口，SMS-A以网关方式和各省SMS-A建立连接。使用 标准CMPP3.0协议。 9. IF9: SMS-A和短消息中心的接口，使用标准SMPP协议。 10. IF10: MMS-A和MMSC的接口，使用MM7协议。 5 QB-D-035-2008 11. IF11:MMS-A和EnmDNS的接口，该接口应符合《中国移动多媒体信息业务ENUM-DNS 接口和设备规范》的要求。 6. 接口定义 6.1 IAGW-A和IAGW-M之间的接口 6.1.1 简介 本节定义IAGW-A和IAGW-M之间的接口。描述的接口列表如下表所示。 消息ID名称 消息ID取值 消息说明 接入模块与管理模块之间的消息 id_LoginReq 0x00000001 登录请求 id_LoginRsp 0x80000001 登录响应 id_AuthUserReq 0x00000002 鉴权请求 id_AuthUserRsp 0x80000002 鉴权响应 id_ResultNotifyReq 0x00000005 业务下发结果通知请求 id_ResultNotifyRsp 0x80000005 业务下发结果通知响应 id_ShakehandReq 0x00000003 链路测试请求 id_ShakehandRsp 0x80000003 链路测试响应 id_LogoutReq 0x00000004 注销请求 id_LogoutRsp 0x80000004 注销响应 6.1.2 协议描述 1. 基本数据类型 无符号整数(4字节) Unsigned Integer4 整数(4字节) Integer4 整数(2字节) integer2 integer1 unsigned char 定长字符串，位数不足时，如果左补0则补ASCII表示Octet String 的零，如果右补0则补二进制的零 以NULL结尾的String C-Octet String 2. 消息结构 项目 说明 消息头(所有消息公共包头) Message Header 消息体 Message Body 3. 消息头格式(Message Header) 6 QB-D-035-2008 字节数 描述 字段名类型 消息总长度(含消息头及消息体) Total_Length 4 Unsigned Integer 命令或响应类型 Command_Id 4 Unsigned Integer 消息流水号,顺序累加,步长为1,循Sequence_Id 4 Unsigned Integer 环使用(一对请求和应答消息的 流水号必须相同) 6.1.3 协议栈 IAGW-A与IAGW-M之间的接口协议以TCP/IP作为底层通信承载，具体结构由图6-1所示: IAGW-A IAGW-M 接口协议 接口协议 TCP TCP IP IP 底层承载 底层承载 图6-1 协议栈 6.1.4 通信方式 现阶段，要求IAGW-A与IAGW-M之间采用TCP长连接方式，且同一个IAGW-A和同一个IAGW-M之间能够采用多连接方式(连接数大于1)进行通信，多条连接之间负载均衡，共同分担信息流量。 所谓长连接，是指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。 参数C、T、N原则上应可配置，现阶段建议取值为:C=3分钟，T=60秒，N=3。 IAGW-A与IAGW-M之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为:T=60秒，N=3。 7 QB-D-035-2008 6.1.5 接口说明 6.1.3.1 登录消息 1. 登录请求 , 方向: IAGW -A -> IAGW-M , 参数: 字段名 字节数 属性 描述 Source_Addr 源地址，此处为IAGW-A编号。 6 Octet String 用于鉴别源地址。其值通过单向MD5 AuthenticatorSourc16 Octet hash计算得出，表示如下: e String AuthenticatorSource = MD5(Source_Addr+9 字节的0 +shared secret+timestamp) Shared secret 由中国移动与源地址 实体事先商定，timestamp格式为: MMDDHHMMSS，即月日时分秒，10 位。 双方协商的版本号(高位4bit表示主版Version 1 Unsigned 本号,低位4bit表示次版本号) Integer Unsigned 时间戳的明文,由客户端产生,格式为Timestamp 4 IntegerMMDDHHMMSS，即月日时分秒，10 位数字的整型，右对齐 。 录响应 2. 登 , 方向:IAGW-M -> IAGW-A , 参数: 字段名 字节数 描述 属性 Status 1 Unsigned 状态 Integer 0:正确 1:消息结构错 2:非法源地址 3:认证错 4:版本太高 5~ :其他错误 Authenticator 16 Octet String 认证码，用于鉴别IAGW-A。 其值通过单向MD5 hash计算得出，表 示如下: Authenticator =MD5 (Status+AuthenticatorSource+shar ed secret)，Shared secret 由中国 8 QB-D-035-2008 移动与源地址实体事先商定， AuthenticatorSource为源地址实体发 送给IAGW-M的对应消息登陆请求中 的值。 认证出错时，此项为空。 Version 1 Unsigned 服务器支持的最高版本号 Integer 6.1.3.2 鉴权消息 IAGW-A在处理MO或MT短信、彩信时，向行业网关管理模块(IAGW-M)发送鉴权消息，IAGW-M根据鉴权消息的内容进行相应鉴权操作。 1. 鉴权请求 , 消息方向:IAGW-A-> IAGW-M , 参数 字段名 类型 长度 描述 Send_Address TDeviceAddr 发送方的地址 Dest_Address TDeviceAddr 接收方的地址 Msg_Id Octet String 25 信息标识 FeeUser_ID TUserID 计费用户标识，MO时填空，MT时填计费号 码 User_ID TUserID 使用业务的手机用户标识，MO时填主叫用 户手机号码，MT时填目的用户手机号码 AccessNum Octet String 21 接入号，对应EC/SI的服务代码 短信MO:填用户发送短信的目的号码 短信MT:填EC/SI服务代码，消息中的源地 址 彩信MO:填用户发送彩信的目的号码 彩信MT:填EC/SI服务代码，消息中的 VASID字段 ServiceCode Octet String 10 业务代码，业务的标志，是数字、字母和符 号的组合 短信MO:填空 短信MT:填业务代码 彩信MO:填空 彩信MT:填业务代码，消息中的 ServiceCode LinkedID Octet String 20 点播消息的匹配标识符 ServiceType Unsigned 4 业务类型: Integer 1:SMSMO 9 QB-D-035-2008 2:SMSMT 3:MMSMO 4:MMSMT 5:WAP PUSH 6~ 待扩展 Unsigned 1 CMPP_SUBMIT消息中的资费类别，保留FeeType Char 字段，可不处理。 1:对“计费用户号码”免费 2:对“计费用户号码”按条计信息费 3:对“计费用户号码”按包月收取信息费 4:对“计费用户号码”的信息费封顶 5:对“计费用户号码”的收费是由EC/SI 实现 Integer 4 SUBMIT消息中的费率，保留字段，可以不Money 处理。MO时填空 可选字段定义 MsgFmt TMsgFmt 参见7可OperStr的编码格式 选字段定 义 OperStr TSMSConte参见7可短消息内容，用于分析用户操作指令。 nt 选字段定短信MO时填短信内容，短信MT时不填。 义 Pk_total TPk_total 参见7可相同LINK_ID的信息总条数。 选字段定 义 Pk_number TPk_number 参见7可相同LINK_ID的信息序号，从1开始。 选字段定 义 其中: TDeviceAddr的定义为: 字段名 类型 长度 描述 DeviceType Unsigned 4 设备类型。 Integer 0:IAGW-M 100:IAGW-A DeviceID Octet String 20 设备编码 TUserID的定义为: 字段名 类型 长度 描述 UserIDType Unsigned 4 用户ID类型。 Integer 1:手机号标识 2:伪码标识(保留字段，与CMPP3.0兼容) 10 QB-D-035-2008 UserID Octet String 50 用户ID 2. 鉴权响应 , 方向:IAGW-M->IAGW-A , 参数 字段名 类型 长度 描述 Result Unsigned 4 返回码 Integer FeeType Unsigned 4 计费类型: Integer 1:免费 2:按条计费 3:包月计费 Money Unsigned 4 费率 Integer FeeUserID Octet String 21 计费用户手机号，MO时填空，MT时填计 费号码 UserID Octet String 21 使用业务的用户手机号，MO时填主叫用 户手机号码，MT时填目的用户手机号码 SendSPUserIDUnsigned 4 传递给EC/SI的用户表示类型 Type Integer 1:传手机号 2:传伪码(保留，与CMPP3.0兼容) OperType Unsigned 4 本消息的操作类型。 Integer 1:订购业务 2:退订业务 3:点播MO 4:透传MO 5:MT 6:查询MO 7:其他 (IAGW-M匹配指令失败时，填写 此值，返回鉴权成功，并携带帮助短信) 8~ 待扩展 LinkedID Octet String 20 点播关系的匹配标识符 FeeUserType Unsigned 4 计费用户类型。 Integer 0:非智能网用户 1:智能网神州行 2~ 待扩展 UserType Unsigned 4 使用业务的用户类型。 Integer 0:非智能网用户 1:智能网神州行 2~ 待扩展 SI_ID Octet String 12 SI编码，ADC类业务时必须填写SI编码， MAS类业务时本字段必须填空 ServiceCode Octet String 10 业务代码 11 QB-D-035-2008 MsgLevel Unsigned 1 优先级。 Integer 取值为0,9，0为优先级最低，9为优先级 最高。 可选字段定义 FeePseudoCodTFeePseudoC参见7可计费用户伪码，开展伪码业务时使用。 e ode 选字段定 义 PseudoCode TPseudoCode 参见7可使用业务的用户伪码，开展伪码业务时使 选字段定用。 义 ConnectDeviceITConnectDevi参见7可用户归属的短信网关ID。 D ceID 选字段定 义 MsgFmt TMsgFmt 参见7可FeatureStr的编码格式。 选字段定 义 FeatureStr TSMSContent 参见7可IAGW-M要求SMS-A反馈给用户的短信 选字段定内容。 义 如果鉴权应答中带了本字段，则SMS-A 需要使用短信的方式向个人用户下发本 字段中的内容。如果鉴权应答中没有这个 字段，则SMS-A不用向个人用户发送短 信。 TextSignEn TTextSignEn 参见7可英文签名，该字段要求使用ASCII编码， 选字段定不足的部分在后面补0x0 义 TextSignZh TTextSignZh 参见7可中文签名，该字段要求使用UCS2编码， 选字段定不足的部分在后面补0x0 义 EC_ID 参见7可EC客户编码，MAS类业务时必须填写ECTEC_ID 选字段定(MAS)的客户编码， ADC类面向EC开 义 放的业务时必须填写EC(ADC)的客户 编码，ADC类面向个人开发的业务时必须 不返回本字段 ForwardFlag 参见7可IAGW-M指示IAGW-A如何前转信息的标TForwardFlag 选字段定志位 义 0,不前转 1,需要前转 默认值为1，即需要前转 ResultFlag 参见7可IAGW-M指示IAGW-A是否上报业务下发TResultFlag 选字段定结果通知的标志位 义 0,不需要上报 1,需要上报 2,失败时上报 12 QB-D-035-2008 默认值为2，即失败时上报 6.1.3.3 业务下发结果通知 IAGW-M在对IAGW-A返回鉴权应答时，会在应答中指示IAGW-A是否上报业务下发结果通知。IAGW-A下发业务后，根据鉴权应答中的指示，确定是否上报业务下发的结果通知请求给IAGW-M，结果通知请求中携带下发结果和原鉴权的时间。IAGW-M根据“服务代码”+“业务代码”匹配业务，根据下发结果回退业务日、月下发数量累积记录等。IAGW-M可以针对不同业务由BOSS配置业务下发结果上报的策略为“不上报”、“无论下发成功与否都上报”和“仅当下发失败时才上报”三种，缺省默认为“仅当下发失败时才上报”。业务下发结果通知仅在MT消息时才使用，MO消息流程中无业务下发结果通知。 1. 业务下发结果通知请求 , 消息方向:IAGW-A-> IAGW-M , 参数 字段名 类型 长度 描述 Send_Address TDeviceAddr 发送方的地址 Dest_Address TDeviceAddr 接收方的地址 Msg_Id Octet String 25 原消息标识 FeeUser_ID TUserID 计费用户标识， MT时填计费号码 User_ID TUserID 使用业务的手机用户标识， MT时填目的用 户手机号码 AccessNum Octet String 21 接入号，对应EC/SI的服务代码 短信MT:填EC/SI服务代码，消息中的源地 址 彩信MT:填EC/SI服务代码，消息中的 VASID字段 ServiceCode Octet String 10 业务代码，业务的标志，是数字、字母和符 号的组合 短信MT:填原鉴权响应中的业务代码 彩信MT:填原鉴权响应中的业务代码，消 息中的ServiceCode ServiceType Unsigned 4 业务类型: Integer 2:SMSMT 4:MMSMT 5:WAPPush 6,:待扩展 AuthTime Octet String 14 原鉴权时间。 取值为14个字节的数字字符串，格式为 YYYYMMDD24HHMISS。 13 QB-D-035-2008 例如:20071016212800。 Result Unsigned 4 业务下发状态。 Integer 取值为4字节整数: 0— 成功 其它值失败 可选字段定义 Pk_total TPk_total 参见7可相同LINK_ID的信息总条数。 选字段定 义 Pk_number TPk_number 参见7可相同LINK_ID的信息序号，从1开始。 选字段定 义 其中: TDeviceAddr的定义为: 字段名 类型 长度 描述 DeviceType Unsigned 4 设备类型。 Integer 0:IAGW-M 100:IAGW-A DeviceID Octet String 20 设备编码 TUserID的定义为: 字段名 类型 长度 描述 UserIDType Unsigned 4 用户ID类型。 Integer 1:手机号标识 2:伪码标识(保留字段，与CMPP3.0兼容) UserID Octet String 50 用户ID 2. 业务下发结果通知响应 , 方向:IAGW-M->IAGW-A , 参数 字段名 类型 长度 描述 Result Unsigned 4 返回码 Integer 6.1.3.4 链路测试消息 1 链路测试请求 , 方向:IAGW-M->IAGW-A 或者 IAGW-A ->IAGW-M , 参数: 14 QB-D-035-2008 无消息体。 2 链路测试响应 , 方向:IAGW-A ->IAGW-M 或者 IAGW-M->IAGW-A (与链路测试请求方向相 反) , 参数: 字段名 字节数 属性 描述 Reserved 1 6.1.3.5 注销消息 1. 注销请求 , 方向:IAGW-A->IAGW-M , 参数: 无消息体，该条消息的目的在于拆除当前的连接。 2. 注销响应 , 方向:IAGW-M->IAGW-A , 参数: 无消息体，该条消息的目的在于拆除当前的连接的应答。 6.1.6 返回码定义 值 说明 0 正确 1 消息结构错 2 非法源地址 3 认证错 4 版本太高 5 命令字错 6 消息序号重复 7 消息长度错 8 资费代码错 9 超过最大信息长 10 流量控制错 100 手机号码不存在 101 手机号码错误 102 用户停机 103 用户欠费 104 用户没有使用该业务的权限 105 业务代码错误 106 服务代码错误 15 QB-D-035-2008 107 业务不存在 108 该业务暂停服务 109 该服务种类不存在 110 该服务种类尚未开通 111 该业务尚未开通 112 EC/SI代码错误 113 EC/SI不存在 114 EC/SI暂停服务 115 用户没有签约该业务 116 用户暂停签约该业务 117 该业务不能对该用户开放 118 用户已经签约了该业务 119 用户不能取消该业务 120 话单格式错误 121 没有该类业务 122 接收异常 123 业务价格为负 124 业务价格格式错误 125 业务价格超出范围 126 该用户不是神州行用户 127 该用户没有足够的余额 128 补款,冲正失败 129 用户已经是梦网用户 131 BOSS系统数据同步出错 132 相关信息不存在 133 用户数据同步出错 134 SP数据同步出错 135 业务数据同步出错 136 用户密码错误 137 伪码信息错误 138 用户相关信息不存在 139 下发时间段违法 140 用户不在白名单中 141 用户处在黑名单中 142 超过日最大发送MT数量 143 超过月最大发送MT数量 144 用户在全局黑名单中 145 用户在EC黑名单中 146 用户在SI黑名单中 147 用户未点播该业务 148 超过每周向同一个用户下发信息的限制 149 超过每月向同一个用户下发信息的限制 16 QB-D-035-2008 6.2 IAGW-M和BOSS之间的接口 有限公司IAGW-M与一级BOSS的接口请参见《BBOSS与全网网关接口规范单行本》、省公司IAGW-M与省BOSS的接口请参见《省BOSS与行业网关接口规范》。 6.3 SMS-A和周边部件的接口 6.3.1 SMS-A和IAGW-M的接口 该接口采用行业应用鉴权协议，参见本协议6.1节。 6.3.2 SMS-A和BOSS之间的接口 该接口采用FTP传送计费话单，话单格式参见《行业应用网关设备规范——短信&WAPPush分册》。 6.3.3 SMS-A和ISMG/SMS-A之间的接口 该接口使用CMPP3.0协议，参见《中国移动通信互联网短信网关接口协议》。 6.3.4 SMS-A和EC/SI之间的接口 该接口使用CMPP2.0及以上版本协议，参见《中国移动通信互联网短信网关接口协议》。 6.3.5 SMS-A和短消息中心之间的接口 该接口使用SMPP协议，参见相关标准。 6.4 MMS-A和周边部件的接口 6.4.1 MMS-A和IAGW-M的接口 该接口采用行业应用鉴权协议，参见本协议6.1节。 6.4.2 MMS-A和BOSS之间的接口 该接口采用FTP传送计费话单，话单格式参见《行业应用网关设备规范,彩信分册》。 17 QB-D-035-2008 6.4.3 MMS-A和MMSC之间的接口 该接口使用MM7协议，参见《中国移动多媒体消息接口规范》。 6.4.4 MMS-A和EC/SI之间的接口 该接口使用MM7协议，参见《中国移动多媒体消息接口规范》。 6.4.5 MMS-A和EnmDNS之间的接口 该接口应该符合《中国移动多媒体信息业务ENUM-DNS接口和设备规范》的要求。 6.5 EC/SI和BOSS之间的接口 该接口参见《集团业务支撑系统文件接口规范为1.0.4行业SI、EC部分》。 7. 可选字段定义 IAGW-M需要同时支持SMS-A和MMS-A的鉴权，以及结果通知。考虑到扩展性和接口性能，鉴权消息需要支持可选字段。 Tag Length Value)字段定义: TLV( 字段名 类型 长度 描述 Tag Integer2 2 字段的Tag值，能够在本规范中唯一标识该 字段。 Length Integer2 2 字段的实际长度。 Value 参见具体的Length 字段的取值。 字段定义。 TLV类型定义: TLV字段类型 Tag取值 说明 TMsgFmt 0x0001 短消息内容的编码格式。 取值为4字节的整数。 短信行业业务使用。 TSMSContent 0x0002 短消息内容。 取值为字符串类型，最长为200字节。 短信行业业务使用。 TPk_total 0x0003 相同LINK_ID的信息总条数。 取值为4字节的整数。 短信行业业务使用。 18 QB-D-035-2008 TPk_number 0x0004 相同LINK_ID的信息序号，从1开始。 取值为4字节的整数。 短信行业业务使用。 TFeePseudoCode 0x0005 计费用户伪码。 取值为字符串类型，最长为50字节。 TPseudoCode 0x0006 使用业务的用户伪码。 取值为字符串类型，最长为50字节。 TConnectDeviceID 0x0007 用户归属的短信网关ID。 取值为字符串类型，最长为20字节。 短信行业业务使用。 TTextSignEn 0x0008 英文签名信息。 取值为字符串类型，最长为30字节。 SMS最长20字节，MMS最长30字节。 TTextSignZh 0x0009 中文签名信息。 取值为字符串类型，最长为30字节。 SMS最长20字节，MMS最长30字节。 TEC_ID 0x0010 EC编码信息。 取值为数字和字母的字符串组合，最长为18 字节。 TForwardFlag 0x0011 IAGW-M根据配置规则，指示IAGW-A如何前 转信息的标志位 0,不前转 1,需要前转 默认值为1，即需要前转 如果IAGW-M没有携带此TLV字段，则 IAGW-A按照需要前转来执行 取值为定长1字节整型 TResultFlag 0x0012 IAGW-M根据BOSS同步的业务属性，指示 IAGW-A是否上报业务下发结果通知的标志 位 0,不需要上报 1,需要上报 2,失败时上报 默认值为2，即失败时上报 如果IAGW-M没有携带此TLV字段，则 IAGW-A按照失败时上报来执行 取值为定长1字节整型 8. 编制历史 版本号 更新时间 主要内容或重大修改 19 QB-D-035-2008 1.0.0 2006-01-10 1.0.0版本 增加短信正文签名的接口字段;进一步明确各接2.0.0 2007-05-15 口字段的填写内容;增加返回码的定义 调整系统架构图，增加MMS-A及相关网元和接口描述; 调整鉴权消息，支持MMS-A接入IAGW-M进行鉴权; 修改鉴权消息的部分字段为可选字段，以提升性能和增强扩展性; 修改鉴权请求和鉴权响应的部分字段，使之更清晰明确和简洁。 更名为《行业应用接口规范》(上一版本名称为《全3.0.0 2008-04-10 网行业应用接口规范》QB-D-045-2007) 增加6.1.3和6.1.4两小节。 修订A-M模块接口:增加业务下发结果通知消息接口。 修订A-M鉴权应答接口:增加前转标志、EC编码、下发结果通知标志字段，更新OperType操作类型字段、SI_ID(SI编码)字段的定义。 增加144,149的返回错误码定义。 20