短信服务API协议.docxVIP

短信服务一API协议 TOC \o 1-5 \h \z HYPERLINK \l bookmark0 \o Current Document 1通信方式 3 HYPERLINK \l bookmark2 \o Current Document 2消息定义 4 HYPERLINK \l bookmark4 \o Current Document 2.1基本数据类型 4 HYPERLINK \l bookmark6 \o Current Document 2.2消息结构 4 消息头格式 (Message Header) 4 HYPERLINK \l bookmark8 \o Current Document 2.4集团用户(EC)与短信服务平台(SSP)间的消息定义 4 HYPERLINK \l bookmark10 \o Current Document EC 请求连接到 SSP (SSP_CONNECT)操作 4 EC或SSP请求拆除连接(SSP_TERMINATE)操作 6 EC 向 SSP 提交短信(SSP_SUBMIT)操作 6 SSP 向 EC 提交短信(SSP_DELIVER)操作 7 SSP 向 EC 提交账户余额(SSP_REMAIN_NOTIFY)操作 9 HYPERLINK \l bookmark14 \o Current Document SSP向EC送交状态报告(SSP_REPORT )操作 9 链路检测(SSP_ACTIVE_TEST)操作 11 HYPERLINK \l bookmark20 \o Current Document 3 Command_Id 定义 11 4API 说明 12 1通信方式 通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有 数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超 过时间T后未收到响应，应立即再发送链路检测包，再连续发送N?1次后仍未得到响应则 断开此连接。 参数C、T、N原则上应可配置，现阶段建议取值为：03分钟，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表