2022年短信接口 .pdf

《2022年短信接口 .pdf》由会员分享，可在线阅读，更多相关《2022年短信接口 .pdf（12页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、北京东时方科技有限公司http:/ 中国移动通信集团公司发布中 国 移 动 通 信互 联 网 短 信 网 关 接 口 协 议Ch i n aMo b i l ePo i n tt oPo i n t版 本 号：3.0.0名师资料总结-精品资料欢迎下载-名师精心整理-第 1 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布1 通信方式.32 消息定义.42.1 基本数据类型.42.2 消息结构.42.3 消息头格式（Message Header）.42.4 集团用户(EC)与短信服务平台(SSP)间的消息定义.42.4.1 EC 请求连接到SSP（SSP_CONN

2、ECT）操作.42.4.2 EC 或 SSP请求拆除连接（SSP_TERMINATE）操作.62.4.3 EC 向 SSP提交短信（SSP_SUBMIT）操作 .62.4.4 SSP向 EC 提交短信（SSP_DELIVER）操作 .82.4.5 SSP向 EC 提交账户余额（SSP_REMAIN_NOTIFY）操作 .92.4.6 SSP向 EC 送交状态报告（SSP_REPORT）操作.92.4.7 链路检测（SSP_ACTIVE_TEST）操作 .11 3 Command_Id 定义.11 4API 说明 .12 名师资料总结-精品资料欢迎下载-名师精心整理-第 2 页，共 12 页 -

3、北京东时方科技有限公司http:/ 中国移动通信集团公司发布1 通信方式通信双方以客户-服务器方式建立TCP 连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C 发送链路检测包以维持此连接，当链路检测包发出超过时间 T 后未收到响应，应立即再发送链路检测包，再连续发送N-1 次后仍未得到响应则断开此连接。参数 C、T、N 原则上应可配置，现阶段建议取值为：C=3 分钟，T=60 秒，N=3。网关与 EC 之间、网关之间的消息发送后等待T 秒后未收到响应，应立即重发，再连续发送 N-1 次后仍未得到响应则停发。现阶段建议取值为：T=60 秒，N=3。消息采用并发方式发送，

4、加以滑动窗口流量控制，窗口大小参数W 可配置，现阶段建议为 16，即接收方在应答前一次收到的消息最多不超过16 条。链路检测包链路检测包响应链路检测包链路检测包响应EC 消息 1 客户端服务器端EC 消息 2 对 EC 消息 1 的响应对 EC 消息 2 的响应建立 TCP 连接建 立TCP链 接名师资料总结-精品资料欢迎下载-名师精心整理-第 3 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布2 消息定义2.1 基本数据类型Unsigned Integer 无符号整数Integer 整数，可为正整数、负整数或零Octet String 定长字符串，位数不足时

5、，右补齐，以二进制的零以表示字符串的结束符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 为

6、客户端，向作为服务器端的SSP发起连接请求，在通过身份验证之后EC 与 SSP之间方可进行数据传输。2.4.1 EC 请求连接到 SSP（SSP_CONNECT）操作拆除 TCP 连接名师资料总结-精品资料欢迎下载-名师精心整理-第 4 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布SSP_CONNECT 操作的目的是EC 向 SSP注册作为一个合法EC 身份，若注册成功后即建立了应用层的连接，此后EC 可以通过此连接发送短信。SSP以 SSP_CONNECT_RESP 消息响应SP 的请求。2.4.1.1 SSP_CONNECT消息定义（ECSSP）字段名字

7、节数属性描述Source_Addr6 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 双方协商

8、的版本号(高位4bit 表示主版本号,低位4bit 表示次版本号)，对于 1.0 的版本，高 4bit 为 1，低 4 位为0 Timestamp 4 Unsigned Integer时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐。2.4.1.2 SSP_CONNECT_RESP消息定义（SSP EC）字段名字节数属性描述Status 4 Unsigned Integer 状态0：正确1：消息结构错2：非法源地址3：认证错4：版本太高5：其他错误AuthenticatorSSP 16 Octet String SSP认证码，用于EC 鉴别 SSP

9、。其值通过单向MD5 hash 计算得出，表示如下：AuthenticatorSSP=MD5（Status+AuthenticatorSource+share名师资料总结-精品资料欢迎下载-名师精心整理-第 5 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布d secret），Shared secret 由 SSP与EC 事先商定，AuthenticatorSource为源地址实体发送给ISMG 的对应消息 SSP_Connect中的值。认证出错时，此项为空。Version 1 Unsigned Integer 服务器支持的最高版本号，对于1.0的版本，高4b

10、it 为 1，低 4 位为 0 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消息定义（ECSSP 或 SSP EC）无消息体。2.4.2.2 SSP_TERMINATE_RESP消息定义（ECSSP 或 SSP EC）无消息体

11、。2.4.3 EC 向 SSP 提交短信（SSP_SUBMIT）操作SSP_SUBMIT 操作的目的是EC 在与 ISMG 建立应用层连接后向ISMG 提交短信。ISMG 以 SSP_SUBMIT_RESP 消息响应。2.4.3.1 SSP_SUBMIT消息定义（ECSPP）字段名字节数属性描述名师资料总结-精品资料欢迎下载-名师精心整理-第 6 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布DestUsr_tl 1 Unsigned Integer 接收信息的用户数量(小于等于200 个用户)Dest_terminal_Id 11*DestUsr_tl Oc

12、tet String 接收短信的MSISDN 11 位号码，号码与号码之间无任何间隔Msg_Length 1 Unsigned Integer EC 长短信长度=254 个字节；如 EC 无长短信业务，则长度根据EC 的签名而定，短信内容长度+签名长度=140 字节，否则返回错误Msg_Content Msg_length Octet String 信息内容，GB2312 编码Long_number 5 Octet String 长号码2.4.3.2 SSP_SUBMIT_RESP消息定义（SSP EC）字段名字节数属性描述Msg_Id 8 Unsigned Integer 信息标识，生成算法

13、如下：采用 64 位（8 字节）的整数：（1）时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中bit64bit61：月份的二进制表示；bit60bit56：日的二进制表示；bit55bit51：小时的二进制表示；bit50bit45：分的二进制表示；bit44bit39：秒的二进制表示；（2）序列号：bit32bit1，顺序增加，步长为 1，循环使用。各部分如不能填满，左补零，右对齐。（EC 根据请求和应答消息的Sequence_Id一致性就可得到CMPP_Submit消息的Msg_Id）Result 4 Unsigned Integer结果0：正确1：消息结构错2

14、：命令字错3：消息序号重复4：消息长度错5：超过最大信息长6：流量超过限制7：需充值名师资料总结-精品资料欢迎下载-名师精心整理-第 7 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布2.4.4 SSP 向 EC 提交短信（SSP_DELIVER）操作SSP_DELIVER操 作 的 目 的 是SSP 把 从 行 业 网 关 转 发 来 的 短 信 送 交EC，EC以SSP_DELIVER_RESP 消息回应。2.4.4.1 SSP_DELIVER消息定义（SSPEC）字段名字节数属性描述Msg_Id8 Unsigned Integer行业网管请求的MSG_I

15、D Dest_Id21 Octet String 目的号码EC 的服务代码，前缀为 EC 服务代码的长号码；该号码是手机用户短消息的被叫号码。Src_terminal_Id 11 Octet String 发送短信的MSISDN 11 位号码Msg_Length 1 Unsigned Integer 消息长度的字节数Msg_Content Msg_length Octet String 信息内容2.4.4.2 SSP_DELIVER_RESP消息定义（EC SSP）字段名字节数属性描述Msg_Id 8 Unsigned Integer 对应于 SSP_DELIVER 请求的 Msg_Id Re

16、sult 4 Unsigned Integer结果0：正确1：消息结构错2：命令字错3：消息序号重复4：消息长度错5：超过最大信息长6：流量超过限制7：需充值名师资料总结-精品资料欢迎下载-名师精心整理-第 8 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布2.4.5 SSP 向 EC 提交账户余额（SSP_REMAIN_NOTIFY）操作2.4.5.1 SSP_REMAIN_NOTIFY消息定义（SSPEC）字段名字节数属性描述Remain_count4 Unsigned IntegerEC 的短信余额，系统每小时提供一次数据2.4.5.2 SSP_REMA

17、IN_NOTIFY_RESP消息定义（EC SSP）字段名字节数属性描述Result 4 Unsigned Integer结果0：正确1：消息结构错2：命令字错3：消息序号重复4：消息长度错2.4.6 SSP向 EC 送交状态报告（SSP_REPORT）操作2.4.6.1 SSP_REPORT消息定义（SSPEC）状态报告表示SSP已提交信息到行业网关字段名字节数属性描述Msg_Id8 Unsigned Integer 信息标识名师资料总结-精品资料欢迎下载-名师精心整理-第 9 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布生成算法如下：采用 64 位（8

18、字节）的整数：（1）时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中bit64bit61：月份的二进制表示；bit60bit56：日的二进制表示；bit55bit51：小时的二进制表示；bit50bit45：分的二进制表示；bit44bit39：秒的二进制表示；（2）序列号：bit32bit1，顺序增加，步长为 1，循环使用。各部分如不能填满，左补零，右对齐。Stat 7 Octet String 状态，详见下表FINAL MESSAGE STATES Src_terminal_Id11Octet String 源终端 MSISDN 号码（状态报告时填为 CMPP_

19、SUBMIT 消息的目的终端号码）如Src_terminal_Id 为空则表示该Msg_Id 所对应的目的手机号码均提交成功。Stat 字段定义Message State Final Message States Description DELIVERED DELIVRD Message is delivered to destination EXPIRED EXPIRED Message validity period has Expired，当天的超时信息如最后接受到，会发送DELIVRD状态报告DELETED DELETED Message has been deleted.UNDELI

20、VERABLE UNDELIV Message is undeliverable ACCEPTED ACCEPTD UNKONWN UNKNOWN REJECTED REJECTD 名师资料总结-精品资料欢迎下载-名师精心整理-第 10 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布2.4.6.2 SSP_REPORT_RESP消息定义（EC SSP）字段名字节数属性描述Msg_Id 8 Unsigned Integer 信息标识（CMPP_DELIVER中的 Msg_Id字段）Result 4 Unsigned Integer结果0：正确1：消息结构错2：命

21、令字错3：消息序号重复4：消息长度错2.4.7 链路检测（SSP_ACTIVE_TEST）操作本操作仅适用于通信双方采用长连接通信方式时用于保持连接。2.4.7.1 SSP_ACTIVE_TEST定义（EC SSP 或 SSPEC）无消息体。2.4.7.2 SSP_ACTIVE_TEST_RESP定义（EC SSP 或 SSPEC）无消息体。3 Command_Id 定义消息Command_Id 值说明SSP _CONNECT 0 x00000001 请求连接SSP _CONNECT_RESP 0 x80000001 请求连接应答SSP _TERMINATE 0 x00000002 终止连接S

22、SP_TERMINATE_RESP 0 x80000002 终止连接应答SSP_SUBMIT 0 x00000003 提交短信SSP_SUBMIT_RESP 0 x80000003 提交短信应答SSP_ACTIVE_TEST 0 x00000004 激活测试SSP_ACTIVE_TEST_RESP 0 x80000004 激活测试应答名师资料总结-精品资料欢迎下载-名师精心整理-第 11 页，共 12 页 -北京东时方科技有限公司http:/ 中国移动通信集团公司发布SSP_REPORT 0 x00000005 状态报告提交SSP_REPORT_RESP 0 x80000005 状态报告提交应答SSP_DELIVER0 x00000006 短信上行请求SSP_DELIVER_RESP0 x80000006 短信上行请求应答SSP_REMAIN_NOTIFY0 x00000007 余额提醒SSP_REMAIN_NOTIFY_RESP0 x80000007 余额提醒应答4API 说明详见 API 测试代码名师资料总结-精品资料欢迎下载-名师精心整理-第 12 页，共 12 页 -