移动短信接口 CMPP30协议.doc

北京东时方科技有限公司 中国移动通信互联网短信网关接口协议China Mobile Point to Point 版本号：3.0.01通信方式32消息定义42.1 基本数据类型42.2 消息结构42.3 消息头格式（Message Header）42.4 集团用户(EC)与短信服务平台(SSP)间的消息定义42.4.1 EC请求连接到SSP（SSP_CONNECT）操作42.4.2 EC或SSP请求拆除连接（SSP_TERMINATE）操作62.4.3 EC向SSP提交短信（SSP_SUBMIT）操作62.4.4 SSP向EC提交短信（SSP_DELIVER）操作72.4.5 SSP向EC提交账户余额（SSP_REMAIN_NOTIFY）操作92.4.6 SSP向EC送交状态报告（SSP_REPORT ）操作92.4.7 链路检测（SSP_ACTIVE_TEST）操作113 Command_Id定义114API说明121通信方式通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。 参数C、T、N原则上应可配置，现阶段建议取值为：C=3分钟，T=60秒，N=3。 网关与EC之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建服务器端客户端议为16，即接收方在应答前一次收到的消息最多不超过16条。拆除TCP连接建立TCP连接对EC消息2的响应对EC消息1的响应EC消息2EC消息1链路检测包 链路检测包响应链路检测包 链路检测包响应 建立TCP链接拆除TCP连接2消息定义2.1 基本数据类型Unsigned Integer 无符号整数Integer整数，可为正整数、负整数或零Octet String定长字符串，位数不足时，右补齐，以二进制的零以表示字符串的结束符2.2 消息结构项目说明Message Header消息头(所有消息公共包头)Message Body消息体2.3 消息头格式（Message Header）字段名字节数属性描述Total_Length4Unsigned Integer消息总长度(含消息头及消息体)Command_Id4Unsigned Integer命令或响应类型Sequence_Id4Unsigned Integer消息流水号,顺序累加,步长为1,循环使用（一对请求和应答消息的流水号必须相同）2.4 集团用户(EC)与短信服务平台(SSP)间的消息定义EC为客户端，向作为服务器端的SSP发起连接请求，在通过身份验证之后EC与SSP之间方可进行数据传输。2.4.1 EC请求连接到SSP（SSP_CONNECT）操作SSP_CONNECT操作的目的是EC向SSP注册作为一个合法EC身份，若注册成功后即建立了应用层的连接，此后EC可以通过此连接发送短信。SSP以SSP_CONNECT_RESP消息响应SP的请求。 SSP_CONNECT消息定义（ECSSP）字段名字节数属性描述Source_Addr6Octet String源地址，此处为EC_Id，即EC的用户代码。不足6位填0.AuthenticatorSource16Octet String用于鉴别源地址。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorSource =MD5（Source_Addr+9 字节的0 +shared secret+timestamp）Shared secret 由SSP与EC实现商定，timestamp格式为：MMDDHHMMSS，即月日时分秒，10位。Version1Unsigned Integer双方协商的版本号(高位4bit表示主版本号,低位4bit表示次版本号)，对于1.0的版本，高4bit为1，低4位为0Timestamp4Unsigned Integer时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐 。 SSP_CONNECT_RESP消息定义（SSP EC）字段名字节数属性描述Status4Unsigned Integer状态0：正确1：消息结构错 2：非法源地址 3：认证错 4：版本太高 5 ：其他错误AuthenticatorSSP16Octet StringSSP认证码，用于EC鉴别SSP。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorSSP=MD5（Status+AuthenticatorSource+shared secret），Shared secret 由SSP与EC事先商定，AuthenticatorSource为源地址实体发送给ISMG的对应消息SSP_Connect中的值。 认证出错时，此项为空。Version1Unsigned Integer服务器支持的最高版本号，对于1.0的版本，高4bit为1，低4位为02.4.2 EC或SSP请求拆除连接（SSP_TERMINATE）操作SSP_TERMINATE操作的目的是EC或SSP基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后EC与SSP之间的应用层连接被释放，此后EC若再要与ISMG通信时应发起SSP_CONNECT操作。SSP或EC以SSP_TERMINATE_RESP消息响应请求。 SSP_TERMINATE消息定义（ECSSP或SSP EC）无消息体。 SSP_TERMINATE_RESP消息定义（ECSSP或SSP EC）无消息体。2.4.3 EC向SSP提交短信（SSP_SUBMIT）操作SSP_SUBMIT操作的目的是EC在与ISMG建立应用层连接后向ISMG提交短信。ISMG以SSP_SUBMIT_RESP消息响应。 SSP_SUBMIT消息定义（ECSPP）字段名字节数属性描述DestUsr_tl1Unsigned Integer接收信息的用户数量(小于等于200个用户)Dest_terminal_Id11*DestUsr_tlOctet String接收短信的MSISDN 11位号码，号码与号码之间无任何间隔 Msg_Length1Unsigned IntegerEC长短信长度=254个字节 ；如EC无长短信业务，则长度根据EC的签名而定，短信内容长度+签名长度=140字节，否则返回错误Msg_ContentMsg_lengthOctet String信息内容，GB2312编码Long_number5Octet String长号码 SSP_SUBMIT_RESP消息定义（SSP EC）字段名字节数属性描述Msg_Id8Unsigned Integer信息标识，生成算法如下：采用64位（8字节）的整数：（1） 时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中bit64bit61：月份的二进制表示；bit60bit56：日的二进制表示；bit55bit51：小时的二进制表示；bit50bit45：分的二进制表示；bit44bit39：秒的二进制表示；（2） 序列号：bit32bit1，顺序增加，步长为1，循环使用。各部分如不能填满，左补零，右对齐。（EC根据请求和应答消息的Sequence_Id一致性就可得到CMPP_Submit消息的Msg_Id）Result4Unsigned Integer结果0：正确1：消息结构错 2：命令字错 3：消息序号重复4：消息长度错5：超过最大信息长6：流量超过限制7：需充值 2.4.4 SSP向EC提交短信（SSP_DELIVER）操作SSP_DELIVER操作的目的是SSP把从行业网关转发来的短信送交EC，EC以SSP_DELIVER_RESP消息回应。 SSP_DELIVER消息定义（SSPEC）字段名字节数属性描述Msg_Id8Unsigned Integer行业网管请求的MSG_IDDest_Id21Octet String目的号码 EC的服务代码，前缀为EC服务代码的长号码；该号码是手机用户短消息的被叫号码。Src_terminal_Id11Octet String发送短信的MSISDN 11位号码Msg_Length1Unsigned Integer消息长度的字节数Msg_ContentMsg_lengthOctet String信息内容 SSP_DELIVER_RESP消息定义（ EC SSP）字段名字节数属性描述Msg_Id8Unsigned Integer对应于SSP_DELIVER请求的Msg_IdResult4Unsigned Integer结果0：正确1：消息结构错 2：命令字错 3：消息序号重复4：消息长度错5：超过最大信息长6：流量超过限制7：需充值 2.4.5 SSP向EC提交账户余额（SSP_REMAIN_NOTIFY）操作 SSP_REMAIN_NOTIFY消息定义（SSPEC）字段名字节数属性描述Remain_count4Unsigned IntegerEC的短信余额，系统每小时提供一次数据 SSP_REMAIN_NOTIFY_RESP消息定义（ EC SSP）字段名字节数属性描述Result4Unsigned Integer结果0：正确1：消息结构错 2：命令字错 3：消息序号重复4：消息长度错2.4.6 SSP向EC送交状态报告（SSP_REPORT ）操作 SSP_REPORT消息定义（SSPEC）状态报告表示SSP已提交信息到行业网关 字段名字节数属性描述Msg_Id8Unsigned Integer信息标识生成算法如下：采用64位（8字节）的整数：（1） 时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中bit64bit61：月份的二进制表示；bit60bit56：日的二进制表示；bit55bit51：小时的二进制表示；bit50bit45：分的二进制表示；bit44bit39：秒的二进制表示；（2） 序列号：bit32bit1，顺序增加，步长为1，循环使用。各部分如不能填满，左补零，右对齐。Stat7Octet String状态，详见下表 FINAL MESSAGE STATESSrc_terminal_Id11Octet String源终端MSISDN号码（状态报告时填为CMPP_SUBMIT消息的目的终端号码）如Src_terminal_Id为空则表示该Msg_Id所对应的目的手机号码均提交成功。Stat字段定义Message StateFinal Message StatesDescriptionDELIVEREDDELIVRDMessage is delivered to destinationEXPIREDEXPIREDMessage validity period hasExpired，当天的超时信息如最后接受到，会发送DELIVRD状态报告DELETEDDELETEDMessage has been deleted.UNDELIVERABLEUNDELIVMessage is undeliverableACCEPTEDACCEPTDUNKONWNUNKNOWNREJECTEDREJECTD SSP_REPORT_RESP消息定义（EC SSP）字段名字节数属性描述Msg_Id8Unsigned Integer信息标识（CMPP_DELIVER中的Msg_Id字段）Result4Unsigned Integer结果0：正确1：消息结构错 2：命令字错 3：消息序号重复4：消息长度错 2.4.7 链路检测（SSP_ACTIVE_TEST）操作本操作仅适用于通信双方采用长连接通信方式时用于保持连接。 SSP_ACTIVE_TEST定义（EC SSP或SSPEC）无消息体。 SSP_ACTIVE_TEST_RESP定义（EC SSP或SSPEC）无消息体。3 Command_Id定义消息Command_Id值说明SSP_CONNECT0x00000001请求连接SSP _CONNECT_RESP0x80000001请求连接应答SSP _TERMINATE0x00000002终止连接SSP_TERMINATE_RESP0x80000002终止连接应答SSP_SUBMIT0x00000003提交短信SSP_SUBMIT_RESP0x80000003提交短信应