短信接口
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
中国移动通信
互联网短信网关接口协议
C h i n a M o b i l e P o i n t t o P o i n t
版本号: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)操作 (8)
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条。
拆除TCP连接
2消息定义
2.1 基本数据类型
2.2 消息结构
2.3 消息头格式(Message Header)
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的请求。
2.4.1.1 SSP_CONNECT消息定义(EC→SSP)
2.4.1.2 SSP_CONNECT_RESP消息定义(SSP→ EC)
2.4.2 EC或SSP请求拆除连接(SSP_TERMINATE)操作
SSP_TERMINATE操作的目的是EC或SSP基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后EC与SSP之间的应用层连接被释放,此后EC若再要与ISMG通信时应发起SSP_CONNECT操作。
SSP或EC以SSP_TERMINATE_RESP消息响应请求。
2.4.2.1 SSP_TERMINATE消息定义(EC→SSP或SSP → EC)
无消息体。
2.4.2.2 SSP_TERMINATE_RESP消息定义(EC→SSP或SSP → EC)
无消息体。
2.4.3 EC向SSP提交短信(SSP_SUBMIT)操作
SSP_SUBMIT操作的目的是EC在与ISMG建立应用层连接后向ISMG提交短信。
ISMG以SSP_SUBMIT_RESP消息响应。
2.4.
3.1 SSP_SUBMIT消息定义(EC→SPP)
2.4.
3.2 SSP_SUBMIT_RESP消息定义(SSP EC)
2.4.4 SSP向EC提交短信(SSP_DELIVER)操作
SSP_DELIVER操作的目的是SSP把从行业网关转发来的短信送交EC,EC以SSP_DELIVER_RESP消息回应。
2.4.4.1 SSP_DELIVER消息定义(SSP→EC)
2.4.4.2 SSP_DELIVER_RESP消息定义(EC → SSP)
2.4.5 SSP向EC提交账户余额(SSP_REMAIN_NOTIFY)操作
2.4.5.1 SSP_REMAIN_NOTIFY消息定义(SSP→EC)
2.4.5.2 SSP_REMAIN_NOTIFY_RESP消息定义(EC → SSP)
2.4.6 SSP向EC送交状态报告(SSP_REPORT )操作
2.4.6.1 SSP_REPORT消息定义(SSP→EC)
状态报告表示SSP已提交信息到行业网关
Stat字段定义
2.4.6.2 SSP_REPORT_RESP消息定义(EC→ SSP)
2.4.7 链路检测(SSP_ACTIVE_TEST)操作
本操作仅适用于通信双方采用长连接通信方式时用于保持连接。
2.4.7.1 SSP_ACTIVE_TEST定义(EC→ SSP或SSP→EC)
无消息体。
2.4.7.2 SSP_ACTIVE_TEST_RESP定义(EC → SSP或SSP→EC)无消息体。
3 Command_Id定义
中国移动通信集团公司发布