短信接口.docVIP

中国移动通信 互联网短信网关接口协议 China Mobile Point to Point 版本号：3.0.0 1通信方式 3 2消息定义 4 2.1 基本数据类型 4 2.2 消息结构 4 2.3 消息头格式（Message Header） 4 2.4 集团用户(EC)与短信服务平台(SSP)间的消息定义 4 2.4.1 EC请求连接到SSP（SSP_CONNECT）操作 4 2.4.2 EC或SSP请求拆除连接（SSP_TERMINATE）操作 6 2.4.3 EC向SSP提交短信（SSP_SUBMIT）操作 6 2.4.4 SSP向EC提交短信（SSP_DELIVER）操作 7 2.4.5 SSP向EC提交账户余额（SSP_REMAIN_NOTIFY）操作 9 2.4.6 SSP向EC送交状态报告（SSP_REPORT ）操作 9 2.4.7 链路检测（SSP_ACTIVE_TEST）操作 11 3 Command_Id定义 11 4API说明 12 1通信方式 通信双方以客户-服务器方式建立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条。 2消息定义 2.1 基本数据类型 Unsigned Integer 无符号整数 Integer 整数，可为正整数、负整数或零 Octet String 定长字符串，位数不足时，右补齐，以二进制的零以表示字符串的结束符 2.2 消息结构 项目 说明 Message Header 消息头(所有消息公共包头) Message Body 消息体 2.3 消息头格式（Message Header） 字段名 字节数 属性 描述 Total_Length 4 Unsigned Integer 消息总长度(含消息头及消息体) Command_Id 4 Unsigned Integer 命令或响应类型 Sequence_Id 4 Unsigned 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消息定义（EC(SSP） 字段名 字节数 属性 描述 Source_Addr 6 Octet String 源地址，此处为EC_Id，即EC的用户代码。不足6位填\0. AuthenticatorSource 16 Octet String 用于鉴别源地址。其值通过单向MD5 hash计算得出，表示如下： AuthenticatorSource = MD5（Source_Addr+9 字节的0 +shared secret+timestamp） Shared secret 由SSP与EC实现商定，timestamp格式为：MMDDHHMMSS，即月日时分秒，10位。 Version 1 Unsigned Integer 双方协商的版本号(高位4bit表示主版本号,低位4bit表示次版本号)，对于1.0的版本，高4bit为1，低4位为0 Timestamp 4 Unsigned Integer 时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐 。 SSP_CONNECT_RESP消息定义（SSP ( EC） 字段名 字节数 属性 描述 Status 4 Unsigned Integer 状态 0：正确 1：消息结构错 2：非法源地址 3：认证错 4：版本太高 5~ ：其他错误 AuthenticatorSSP 16 Octet Strin