网关接口协议.doc

国移动通信信息资源站实体与互联网短消息网关接口协议（V1.1）中国移动通信集团公司2000/12/126.1长连接ICP与ISMG以ClientServer方式建立TCP连接，用于双方信息的相互提交。TCP/IP连接建立后，由Client发起建立应用层的连接，这时如果ICP或ISMG认为需要建立TLS连接，则在传输的数据包中置TLS字段，从而在双方建立TLS连接。在应用层连接建立后的数据传输过程中，如果ICP或ISMG需要向对端发送加密信息，也可建立TLS连接，这时只需要置相应的消息体中Tls_available（是否使用TLS层）属性字段，且应的本条消息的消息体中的其他属性不发送。消息采用并发方式发送，加以流量控制，窗口大小可调，暂定为16条消息，即接收方在应答前一次收到的消息最多不超过16条。ICP向ISMG发送的消息类型包括：1）CMPP_Connect 请求应用层连接2）CMPP_Terminate 终止应用层连接3）CMPP_Terminate_REP 终止应用层连接应答4）CMPP_Deliver_REP 下发短信应答5）CMPP_Submit 提交短信6）CMPP_Query 发送短信状态查询7）CMPP_Cancel删除短信8）CMPP_Active_Test激活测试9）CMPP_Active_Test_REP激活测试应答ISMG向ICP发送的消息类型包括：1）CMPP_Connect_REP 请求连接应答2）CMPP_Deliver 短信下发3）CMPP_Submit_REP 提交短信应答4）CMPP_Query_REP 短信状态查询结果5）CMPP_Cancel_REP 删除短信应答6）CMPP_Active_Test_REP 激活测试应答7）CMPP_Active_Test 激活测试8) CMPP_Terminate 终止应用层连接9) CMPP_Terminate_Rep 终止应用层连接应答一次操作流程ICP ISMG 说明CMPP_Connect ICP请求与ISMG建立应用层连接 CMPP_ Connect_REP ISMG请求连接应答CMPP_Submit(1) 提交短信，要求确认CMPP_Submit(2) 提交短信，要求确认 CMPP_Submit_REP 对（1）的提交短信响应 CMPP_Submit_REP 对（2）的提交短信响应 CMPP_Terminate 终止应用层连接CMPP_Terminate_Rep 终止应用层连接响应 图6.1 长连接消息流程示意图7消息定义CMPP长连接端口号定义为7890，短连接端口号定义为7900。字节采用在网络中通用的网络序，超时时长间隔采用斐波那契数列，重发次数动态可调，最好不少于3次。基本数据类型：Integer 无符号整数Octet String定长字符串，位数不足时，右补二进制07.1消息结构项目说明Message Header消息头(所有消息公共包头)Message Body消息体7.2 消息头格式（Message Header）字段名字节数类型描述Total_Length4Integer消息总长度(含消息头及消息体)Command_ID4Integer命令或响应类型Sequence_ID4Integer消息流水号,顺序累加,步长为1,循环使用7.3 消息体格式(Message Body)1. CMPP_Connect 请求连接字段名字节数属性描述Source_Addr6Octet StringICP_IDAuthenticatorICP16Octet StringICP认证码 Reverse8Octet String保留项（暂不用）2. CMPP_Connect_REP 请求连接应答字段名字节数属性描述Status1Integer状态0：正确1：消息结构错 2：非法ICP_ID 3：ICP认证错4 ：其他错误AuthenticatorISMG16Octet StringISMG认证码 Tls_available1Integer是否使用TLS协议层3. CMPP_Terminate 终止连接消息体为空。4. CMPP_Terminate_Rep 终止连接响应消息体为空。5.CMPP_Submit 发送短信字段名字节数属性描述Msg_id4Integer信息标识1FFFFFFFFH顺序累加,步长为1,循环使用.Pk_total1Integer相同Msg_id的消息总条数Pk_number1Integer相同Msg_id的消息序号Registered_Delivery1Integer是否要求返回状态确认报告(0-不需要，1-需要)Msg_level1Integer信息级别Service_id10Octet String业务类型Tls_available1Integer是否使用TLS协议层Msg_Fmt1Integer信息格式 0：ASCII串 3：短信写卡操作 4：二进制信息 8：UCS2编码15：含GB汉字 。 Msg_src6Octet String信息内容来源(ICP_ID)FeeType2Octet String资费类别FeeCode6Octet String资费代码（以分为单位）Valid_Time17Octet String存活有效期，格式遵循SMPP3.3协议At_Time17Octet String定时发送时间，格式遵循SMPP3.3协议Src_terminal_id21Octet String源终端MSISDN号码(没有可以为空)DestUsr_tl1Integer接收消息的用户数量(小于100个用户)Dest_terminal_id21*DestUsr_tlOctet String接收业务的MSISDN号码Msg_Length1Integer消息长度(160个字节)Msg_ContentMsg_lengthOctet String消息内容Reserve8Octet String保留6.CMPP_Submit_REP发送短信响应（出错要求ICP全部重发Msg_Id信息）字段名字节数属性描述Msg_Id4Integer消息标识Tls_available1Integer是否使用TLS协议层Result1Integer结果0：正确1：消息结构错 2：命令字错 3：消息序号重复4：消息长度错5：资费代码错6：超过最大信息长7：业务代码错8: 流量控制错9 ：其他错误7.CMPP_Query发送短信状态查询(查询Time属性指定的日期的统计信息)字段名字节数属性描述Tls_available1Integer是否使用TLS协议层Time8Octet String时间(精确至日)Query_Type1Integer查询类别0：总数查询1：按业务代码查询 Query_Code10Octet String查询码 (业务类型)Reserve8Octet String保留8.CMPP_Query_REP短信状态查询结果字段名字节数属性描述Tls_available1Integer是否使用TLS协议层Time8Octet String时间(精确至日)Query_Type1Integer查询类别0：总数查询1：按业务代码查询 Query_Code10Octet String查询码MT_TLMsg4Integer从ICP接收信息总数MT_Tlusr4Integer从ICP接收用户总数MT_Scs4Integer成功转发数量MT_WT4Integer待转发数量MT_FL4Integer转发失败数量MO_Scs4Integer向ICP成功送达数量MO_WT4Integer向ICP待送达数量MO_FL4Integer向ICP送达失败数量9. CMPP_Deliver字段名字节数属性描述Msg_Id4Integer消息标识Msg_Level1Integer信息级别Tls_available1Integer是否使用TLS协议层Service_id10Octet String业务类型Msg_Fmt1Integer信息格式 0：ASCII串 3：短信写卡操作 4：二进制信息 8：UCS2编码15：含GB汉字 。 Srcterminal_id21Octet String源终端MSISDN号码Registered_Delivery1Integer是否为应答信息，0-非应答信息，1-应答信息Msg_Length1Integer消息长度Msg_ContentMsg_lengthOctet String消息内容Reserve8Octet String保留项当CMPP_Deliver为对CMPP_Submit的应答信息时(即状态报告)，信息内容字段格式定义如下：Msg_id4Integer提交的CMPP_Submit包的信息IDStat7Octet String短信的应答结果，含义与SMPP3.3协议补充要求中stat字段定义相同Submit_time10Octet StringYYMMDDHHMM（YY为年的后两位00-99，MM：01-12，DD：01-31，HH：00-23，MM：00-59）Done_time10Octet StringYYMMDDHHMM10.CMPP_Deliver_REP下发短信响应字段名字节数属性描述Msg_Id4Integer消息标识Tls_available1Integer是否使用TLS协议层Result1Integer结果0：正确1：消息结构错 2：命令字错 3：消息序号重复4：消息长度错5：资费代码错6：超过最大信息长7：业务代码错8: 流量控制错9 ：其他错误11.CMPP_Cancel删除短信字段名字节数属性描述Msg_Id4Integer消息标识Tls_available1Integer是否使用TLS协议层12.CMPP_Cancel_REP删除短信响应字段名字节数属性描述Tls_available1Integer是否使用TLS协议层Success_Id1Integer成功标识(0:成功; 1:失败)13.CMPP_Active_Test激活测试字段名字节数属性描述Tls_available1Integer是否使用TLS协议层14.CMPP_Active_Test_REP激活测试响应字段名字节数属性描述Tls_available1Integer是否使用TLS协议层Success_Id1Integer成功标识(0-成功)15. CMPP_Fwd 短信前转字段名字节数属性描述Source_ Id6Octet String源网关的代码（右对齐，左补0）Dest_Id6Octet String目的网关代码（右对齐，左补0）NodesCount1Integer经过的网关数量Tls_available1Integer是否使用TLS协议层Msg_id4Interger信息标识（与Pk_total1Integer相同Msg_id的消息总条数Pk_number1Integer相同Msg_id的消息序号Registered_Delivery1Integer是否要求返回状态确认报告(0-不需要，1-需要，2-此条信息为状态确认报告)Msg_level1Integer信息级别Service_id10Octet String业务类型Msg_Fmt1Integer信息格式 0：ASCII串 3：短信写卡操作 4：二进制信息 8：UCS2编码15：含GB汉字 。 Msg_src6Octet String信息内容来源FeeType2Octet String资费类别FeeCode6Octet String资费代码（以分为单位）Valid_Time17Octet String有效期 At_Time17Octet String定时发送的时间 Srcterminal_id21Octet String源终端MSISDN号码(没有可以为空)DestUsr_tl1Integer接收消息的用户数量 Dest_terminal_id21*DestUsr_tlOctet String接收业务的MSISDN号码Msg_Length1Integet消息长度Msg_ContentMsg_lengthOctet String消息内容（针对状态报告包，内容格式及含义同CMPP_Deliver状态报告包消息内容）Reserve8M保留16. CMPP_Fwd _REP短信前转响应字段名字节数属性描述Msg_Id4Integer消息标识Pk_total1Integer相同Msg_id的消息总条数Pk_number1Integer相同Msg_id的消息序号Tls_available1Integer是否使用TLS协议层Result1Integer结果0：正确1：消息结构错 2：命令字错 3：消息序号重复4：消息长度错5：资费代码错6：超过最大信息长7：业务代码错8: 流量控制错9: 前转判断错(此ICP不应发往本ISMG)10 ：其他错误17. CMPP_Route路由请求字段名字节数属性描述New_Gate1Integer0：普通网关；1：新增加网关Request_Total2Integer0：请求一条；1：请求多条路由表数据（如果后面字段为空，请求路由表全部）Service_Type10Octet String请求的业务类型（此项适合全网服务内容，如爱心卡图片传情）Service_Code4Integer请求的业务代码（如果未置Service_Type字段，此字段为空，如爱心卡图片传情TPCQ1000-2000对应某个网站的某些相应图片）ICP_ID6Octet StringICP的接入代码（如果置Service_Type字段，此字段为空）18. CMPP_Route_REP 路由请求应答字段名字节数属性描述Request_Number2Integer返回的路由表数据条数，此字段值如果大于1（如网关向新增网关请求路由），下面5个字段重复出现Service_Type10Octet string业务类型Service_Code_Start4Integer业务代码起始代码Service_Code_End4Integer业务代码结束代码ICP_ID6Octet StringICP的接入代码（如果置Service_Type字段，此字段为空）ISMG_ID6Octet String对应上述条件的网关代码8编号8.1 ISMG编号地点编号(ISMG_ID暂用区号加顺序号标识)说明北京(01001)斯特奇江西(079101)清华深讯广州(02001)清华深讯天津(02201)其他待定8.2 Command_ID命令字名称Command_ID值说明CMPP_Connect0x00