中国电信企业标准--CTMP开发-中国电信短消息网关协议（SMGP）.docVIP

目 录 1 适用范围 2 2 引用标准 3 3 缩略语 4 4 SMGP协议概述 5 4.1 定义 5 4.2 通信方式 5 4.3 协议应用及涉及的端口号 7 5 SMGP协议 9 5.1 数据类型 9 5.2 消息结构 9 6 参数定义 15 6.1 消息头参数描述 15 6.2 消息体必选参数描述 17 6.3 消息体可选参数描述 32 前 言 本标准规定了企业信使平台与企业用户进行短消息传输的接口协议。 本标准是在SMGP协议V3.0.3的基础上，基于企业信使平台需求进行修订而成。 适用范围 本协议适用于企业信使平台、企业用户设备开发商及内容提供商。 引用标准 下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。 【1】Short Message Peer to Peer Protocol Specification 【2】中国电信CDMA短消息网关设备规范v1.0.1 【3】中国电信CDMA短消息网关测试规范v1.0.1 【4】中国电信综合业务管理平台ISMP接口规范_RC1.0.1_-SS接口 英文全名 中文全名 CTMP China Telecom Message Platform 企业信使平台 SP Service Provider 服务提供商 SMGP Short Message Gateway Protocol 短消息网关协议 SMPP Short Message Point to Point Protocol 短消息点到点协议 SMGP协议概述 定义 SMGP协议是CTMP与CP进行短消息传输的接口协议。 通信方式 所谓长连接，指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。 长连接 通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。 参数C、T、N原则上应可配置，现阶段建议取值为：C=3分钟，T=60秒，N=3。 通信双方之间的消息如果不能成功发送，应隔时间R进行重发，再连续发送N-1次后仍未发送成功则停发。现阶段建议取值为：R=60秒，N=3。 通信双方之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建议为16，即接收方在应答前一次收到的消息最多不超过16条。 长连接的操作流程举例如图1所示： 单连接 一个SP帐号同时只能有一个SMGP连接连到CTMP平台，该连接为双工模式，既可以发送Submit,也可以接收SubmitResp和Deliver消息。 协议应用及涉及的端口号 8900 SMGP协议 数据类型 基本数据类型 Integer 无符号整数 Octet String 不强制以0x00结尾的定长字符串。当位数不足时，在不明确注明的情况下，应左对齐，右补0x00。在明确注明的情况下，以该字段的明确注明为准。 可选参数 可选参数采用TLV（Tag、Length、Value）形式定义，每个可选参数的Tag、Length、Value的定义见6.3节。 字段 长度（字节） 数据类型 说明 Tag 2 Integer 字段的标签，用于唯一标识可选参数 Length 2 Integer 字段的长度 Value 可变长度 可变类型 字段内容 消息结构 项目 说明 Message Header 消息头(所有消息公共包头) Message Body 消息体 消息头结构 字段 长度（字节） 数据类型 说明 参考 PacketLength 4 Integer 数据包长度 6.1.1 RequestID 4 Integer 请求标识 6.1.2 SequenceID 4 Integer 消息流水号 6.1.3 消息体结构 登录操作（Login） Login操作的目的是客户端向服务器端注册作为一个合法客户端身份，若注册成功后即建立了应用层的连接，此后客户端可以与此服务器端进行消息的接收和发送。 服务器端以Login_Resp消息响应客户端的请求。 Login 字段 长度 （字节） 数据类型 说明 参考 必选参数 ClientID 8 Octet String 客户端用来登录服务器端的用户账号。 6.