1、 中国电信20081451 号 关于印发中国电信短消息 网关协议规范（V3.1)的通知 集团公司各省级分公司，股份公司并转各省级分公司： 为更好地适应全业务经营的需要，集团公司组织上海研究院对 2005 年下发的中国电信短消息网关协议规范（V3.0） （中国电信2005240 号）进行了修订，形成了中国电信短消息网关协议（SMGP）规范（V3.1） ，现印发你们，请参照执行。 二八年十二月五日 中国电信集团公司技术标准 Q/CT 2069-20082008-12-10 发布 2008-12-10 实施中国电信集团公司发布保密等级：公开发行中国电信短消息网关协议（SMGP）规范 （V3.1 ）
2、I 目 录 目 录. I 前 言. III 1 范围 . 1 2 规范性引用文件. . 1 3 名词术语 和缩略语. 1 3.1 名词术语. . 1 3.2 缩略语. . 1 4 SMGP 协议概述 . . 1 4.1 定义. 1 4.2 通信方式. . 1 4.2.1 长连接. 1 4.2.2 短连接. 2 4.3 协议应 用及涉及的端口号. 3 4.3.1 固 定网短消息业务. 3 4.3.2 移 动网短消息业务. 5 4.3.3 基 于短消息的电子商务业务 . 5 5 SMGP 协议. 6 5.1 数据类型. . 6 5.1.1 基 本数据类型. 6 5.1.2 可选参数. 6 5.2
3、消息结构. . 6 5.2.1 消息头结构. . 6 5.2.2 消息体结构. . 6 6 SMGP 扩展协议 . . 12 6.1 SMGP 协议扩展计费接口 . . 12 6.1.1 消息头扩展. . 12 6.1.2 消息体扩展. . 12 6.2 SMGP 协议扩展电子商务接口 . 15 6.2.1 消息头扩展. . 15 6.2.2 消息体扩展. . 15 7 参数定义. . 18 7.1 消息头 参数描述 . 18 7.2 消息体 必选参数描述. 19 7.3 消息体 可选参数描述. 32 8 基于SMGP协议的API函数. 37 附 录 A 基于SMGP 协议的API 函数说明.
4、 38 A.1 基本要求. . 38 A.1.1 安装. . 38 A.1.2 例子程序. 38 A.1.3 操 作系统平台要求. 38 A.2 API 数据结构说明（以 C 语言为例） . 38 A.2.1 接收短消息的返回数据结构（Del iverResp）. 3 8 A.2.2 获取群发短消息的返回数据结构（SendBa tchResp）. 39 A.2.3 查询短消息网关的返回数据结构（Que ryResp 可选） . 39 A.3 API 函数说明 . 39 II A.3.1 初始化API（InitSMGPAPI） . 39 A.3.2 发送单条短消息（SMGPS endSingle
5、）. 40 A.3.3 群发短消息（SMGP SendBatch）. . 40 A.3.4 获取群发短消息的结果（GetSen dBatchResp）. .41 A.3.5 接收短消息（SMGP Deliver）. . 42 A.3.6 检查短消息网关是否能够提供服务（CMMPAc tiveTest）. 42 A.3.7 查询短消息流量（SMG PQuery 可选） .42 A.4 配置SMGP API . 42 A.5 短消息 的自动分割功能. . 43 A.6 错误代码含义. . 43 附 录 B 短消息群发功能的实现 . 45 III 前 言 本规范是依据 SMGP 协议 V3.0 的相
6、关内容，结合中国电信 C 网业务网络 SMS 的特点进行编写，随着中国电信业务网络 SMS 的发展完善，还将制定后续的相关规范要求。 本规范规定了短消息网关与其它网元之间进行短消息传输的接口协议。 本标准共包含 3 部分： 1、SMGP 基本协议；2 、 SMGP 协议扩展计费接口；3 、SMGP协议扩展电子商务接口。本文只描述了第 1 部分 SMGP 基本协议，第 2 部分和第 3 部分同SMGP 协议 V2.0。 本标准由中国电信集团公司提出并归口。 本标准起草单位：中国电信股份有限公司上海研究院 本标准主要起草人：蒋力 施唯佳 葛敏 顾丽丽 周文君 王建 中国电信短消息网关 SMGP 接
7、口协议规范（V3.1 ） 1 1 范围 本协议适用于短消息网络上（固定网、移动网）短消息网关与其它网元之间进行短消息的传输。 本协议适用于短消息网关、相关网元设备开发商及内容提供商。 2 规范性引用文件 下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。 【1 】 中国电信短消息网关协议（SMGP ） V3.0 【2 】 中国电信 CDMA 业务网络设备技术规范短消息业务网关（SMSGW）设备 技术规范 3 名词术语和缩略语 3.1 名词术语 ESME：外部短消息实体，通常
8、通过 SMPP 协议接入到短消息中心。 SMSC：短消息业务中心，提供短消息的存储、转发等功能。 SMGW：短消息业务接入网关，提供短消息与外部网络的互通和短信增值业务的接入等功能。 3.2 缩略语 缩略语 英文解释 中文解释 ESME External Short Message Entity 外部短消息实体SP Service Provider 服务提供商 SMSC Short Message Service Center 短消息业务中心 SMGP Short Message Gateway Protocol 短消息网关协议 SMGW Short Message Gateway 短消息网关
9、 SMPP Short Message Point to Point Protocol 短消息点到点协议 4 SMGP 协议概述 4.1 定义 SMGP 协议是 SMGW 与其它网元设备（除 SMC 外）进行短消息传输的接口协议。 非 SMC 网元设备向 SMGW 发送或从 SMGW 接收短消息，这些非 SMC 网元设备称为ESME。 4.2 通信方式 SMGW 与 ESME 之间共有两种连接方式：长连接和短连接。所谓长连接，指在一个TCP 连接上可以连续发送多个数据包，在 TCP 连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个
10、TCP 连接，数据发送完成后，则断开此 TCP 连接， 即每次 TCP 连接只完成一对 SMGP 消息的发送。 4.2.1 长连接 通信双方以客户- 服务器方式建立 TCP 连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间 C 发送链路检测包以维持此连接，当链路检测包发出超过时间 T 后未收到响应，应立即再发送链路检测包，再连续发送 N-1 次后仍未得到响应则断开此连接。 参数 C、T、 N 原则上应可配置，现阶段建议取值为：C=3 分钟，T=60 秒，N=3 。 通信双方之间的消息如果不能成功发送，应隔时间 R 进行重发，再连续发送 N-1 次后仍未发送成功则停发。现
11、阶段建议取值为：R=60 秒，N=3 。 通信双方之间的消息发送后等待 T 秒后未收到响应，应立即重发，再连续发送 N-1 次后仍未得到响应则停发。现阶段建议取值为：T=60 秒，N=3 。 2 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数 W 可配置，现阶段建议为 16，即接收方在应答前一次收到的消息最多不超过 16 条。 长连接的操作流程举例如图 4.1 所示： 4.2.2 短连接 通信双方以客户- 服务器方式建立 TCP 连接，应答与请求在同一个连接中完成。系统采. . . . . . 滑动窗口不大于SMGP 消息 1
12、客户端 服务器端SMGP 消息 2对 SMGP 消息 1 的响对 SMGP 消息 2 的响链路检测包链路检测包响应建立 TCP 连接链路检测包链路检测包响应拆除 TCP 连接. . . . . . 图 4.1 长连接操作流程 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） 3 用客户/ 服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。 通信双方之间的消息发送后等待 T 秒后未收到响应，应立即重发，再连续发送 N-1 次后仍未得到响应则停发。现阶段建议取值为：T=60 秒，N=3 。 短连接的操作流程举例如图 4.2 所示： 4.3 协议应用及涉及的端口号 SM
13、GP 协议在中国电信中的应用主要体现在两类短消息业务上：一类是固定网短消息业务，另一类是移动网短消息业务。 4.3.1 固定网短消息业务 对 SMGP 消息 1 的响应SMGP 消息 1 建立 TCP 连接 拆除 TCP 连接 SMGP 消息 2 对 SMGP 消息 2 的响应建立 TCP 连接 拆除 TCP 连接 . . . . . . 客户端 服务器端图 4.2 短连接操作流程 4 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） SMGP 及 SMGP扩展计费接口 SMGPSMGP SMGP SP SMC 预付费平台 固定终端 (PHS,”家加 e”)SMC 预付费 平台 SP
14、一级 SMGW 二级 SMGW 固定网(PHS,PSTN)固定终端 (PHS,”家加 e”)固定网(PHS,PSTN)二级 SMGW SP SMGP 扩展计费接口 SMGP扩展计费接口 SMGP 及 SMGP扩展计费接口 图 4.3 固定网短消息业务系统结构简图 固定网短消息业务系统结构简图如图 4.3 所示。 SMGP 协议在固网短消息系统中应用情况如下： （1 ） 二级 SMGW 与 SP 二级 SMGW 与 SP 之间采用 SMGP 协议进行短消息的传输，端口号为 8890，二级SMGW 为服务器端，SP 为客户端； （2 ） 二级 SMGW 与一级 SMGW 二级 SMGW 与一级 S
15、MGW 之间采用 SMGP 协议进行短消息的传输，端口号为8900，二级 SMGW 与一级 SMGW 互为客户/ 服务器端； 二级 SMGW 与一级 SMGW 之间采用 SMGP 协议扩展计费接口( 参见 SMGP V2.0)进行计费信息的传输，端口号为 8900，二级 SMGW 作为服务器端，一级 SMGW作为客户端； （3 ） 一级 SMGW 与 SP 一级 SMGW 与 SP 之间采用 SMGP 协议进行短消息的传输，端口号为 8890，一级SMGW 为服务器端，SP 为客户端； （4 ） 二级 SMGW 和 PHS 预付费平台 二级 SMGW 与 PHS 预付费平台之间采用 SMGP
16、协议扩展计费接口( 参见 SMGP V2.0)进行计 费信息的传输，端口号为 9100，预付费平台作为服务器端，二级 SMGW作为客户端。 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） 5 4.3.2 移动网短消息业务 移动网短消息业务系统结构简图如图 4.4 所示。 SMGP 协议在移动网短消息系统中应用情况如下： （1 ） SMGW 与 SP SMGW 与 SP 之间采用 SMGP 协议进行短消息的传输，端口号为 8890， SMGW 为服务器端，SP 为客户端； （2 ） SMGW 与 SMGW SMGW 与 SMGW 之间采用 SMGP 协议进行短消息的传输，端口号为 89
17、00， SMGW与 SMGW 互为客户/ 服务器端； 4.3.3 基于短消息的电子商务业务 专业 SP AAA服务器FSK 接入 服务器 信息 终端 CTSI 服务器交易模块二级短信综合网关 交易模块(业务网关模块) 一级短信综合网关交易模块SMC SMGP 扩展电子商务接口 扩展 SMPP 扩展 CTSI SMGP 扩展电子商务接口 图 4.5 基于短消息的电子商务业务系统结构简图 SMGW SMGW SMC SMC 图 4.4 移动网短消息业务系统结构简图 SMGP SMGP SP SP SMGP 移动网 移动网 移动网终端 移动网终端 6 中国电信短消息网关 SMGP 接口协议规范（V3
18、.1 ） 基于短消息的电子商务业务系统结构简图如图 4.5 所示。 SMGP 协议在基于短消息的电子商务业务中应用情况如下： （1 ） 二级短信综合网关与专业 SP 二级短信综合网关与专业 SP之间通过 SMGP协议扩展电子商务接口开展基于短消息的电子商务业务，端口号为 9001，二级短信综合网关为服务器端， SP 为客户端； （2 ） 二级短信综合网关与一级短信综合网关 二级短信综合网关与一级短信综合网关之间通过 SMGP 协议扩展电子商务接口开展基于短消息的电子商务业务，端口号为 9001，二级短信综合网关与一级短信综合网关互为客户/ 服务器端； 5 SMGP 协议 5.1 数据类型 5.
19、1.1 基本数据类型 Integer 无符号整数 Octet String 不强制以 0x00 结尾的定长字符串。当位数不足时，在不明确注明的情况下，应左对齐，右补 0x00。在明确注明的情况下，以该字段的明确注明为准。 5.1.2 可选参数 可选参数采用 TLV（Tag 、Length、Value ）形式定义，每个可选参数的 Tag、Length、Value 的定义见 6.3 节。 字段 长度（字节） 数据类型 说明 Tag 2 Integer 字段的标签，用于唯一标识可选参数 Length 2 Integer 字段的长度 Value 可变长度 可变类型 字段内容 5.2 消息结构 项目 说
20、明 Message Header 消息头( 所有消息公共包头) Message Body 消息体 5.2.1 消息头结构 字段 长度（字节） 数据类型 说明 参考 PacketLength 4 Integer 数据包长度 7.1.1 RequestID 4 Integer 请求标识 7.1.2 SequenceID 4 Integer 消息流水号 7.1.3 5.2.2 消息体结构 5.2.2.1 登录操作（Login） Login 操作的目的是客户端向服务器端注册作为一个合法客户端身份，若注册成功后即建立了应用层的连接，此后客户端可以与此服务器端进行消息的接收和发送。 服务器端以 Login
21、_Resp 消息响应客户端的请求。 5.2.2.1.1 Login 字段 长度（字节） 数据类型 说明 参考 必选ClientID 8 Octet String 客户端用来登录服务器端的用户账号。 7.2.1 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） 7 AuthenticatorClient 16 Octet String 客户端认证码，用来鉴别客户端的合法性。 7.2.2 LoginMode 1 Integer 客户端用来登录服务器端的登录类型。 7.2.3 TimeStamp 4 Integer 时间戳 7.2.4 参数 ClientVersion 1 Integer 客
22、户端支持的协议版本号 7.2.5 5.2.2.1.2 Login_Resp 字段 长度（字节） 数据类型 说明 参考 Status 4 Integer 请求返回结果 7.2.6 AuthenticatorServer 16 Octet String 服务器端返回给客户端的认证码 7.2.7 必选参数 ServerVersion 1 Integer 服务器端支持的最高版本号 7.2.8 5.2.2.2 SP 向 SMGW 提交短消息的操作（Submit） 5.2.2.2.1 Submit 字段 长度（字节） 数据类型 说明 参考 MsgType 1 Integer 短消息类型 7.2.9 Nee
23、dReport 1 Integer SP 是否要求返回状态报告 7.2.10 Priority 1 Integer 短消息发送优先级 7.2.11 ServiceID 10 Octet String 业务代码 7.2.12 FeeType 2 Octet String 收费类型 7.2.13 FeeCode 6 Octet String 资费代码 7.2.14 FixedFee 6 Octet String 包月费/ 封顶费 7.2.15 MsgFormat 1 Integer 短消息格式 7.2.16 ValidTime 17 Octet String 短消息有效时间 7.2.17 AtTi
24、me 17 Octet String 短消息定时发送时间 7.2.18 SrcTermID 21 Octet String 短信息发送方号码 7.2.19 ChargeTermID 21 Octet String 计费用户号码 7.2.20 必 选 参 数 DestTermIDCount 1 Integer 短消息接收号码总数 7.2.21 8 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） DestTermID 21*DestTermCount Octet String* 短消息接收号码 7.2.22 MsgLength 1 Integer 短消息长度 7.2.23 MsgCont
25、ent MsgLength Octet String 短消息内容 7.2.24 Reserve 8 Octet String 保留 7.2.25 字段 数据类型 说明 参考 TP_pid TLV GSM 协议类型 7.3.2 TP_udhi TLV GSM 协议类型 7.3.3 LinkID TLV 交易标识 7.3.4 MsgSrc TLV 信息内容的来源 7.3.17 ChargeUserType TLV 计费用户类型 7.3.5 ChargeTermType TLV 计费用户的号码类型 7.3.6 ChargeTermPseudo TLV 计费用户的伪码 7.3.7 DestTermTy
26、pe TLV 短消息接收方号码的类型 7.3.8 DestTermPseudo TLV 短消息接收方的伪码 7.3.9 PkTotal TLV 相同 MsgID 的消息总条数 7.3.10 PkNumber TLV 相同 MsgID 的消息序号 7.3.11 SubmitMsgType TLV SP 发送的消息类型 7.3.12 SPDealResult TLV SP 对消息的处理结果 7.3.13 可选参数 MServiceID TLV 业务代码（用于移动网业务） 7.3.19 短信平台支持短信的群发功能，关于短信群发功能的实现请参阅“附录 B 短消息群发功能的实现”。 5.2.2.2.2
27、Submit_Resp 字段 长度（字节） 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 7.2.26 必选参数 Status 4 Integer 请求返回结果 7.2.6 5.2.2.3 SMGW 向 SP 下发短消息的操作（Deliver） 5.2.2.3.1 Deliver 字段 长度（字节） 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 7.2.26 IsReport 1 Integer 是否为状态报告 7.2.27 必 MsgFormat 1 Integer 短消息格式 7.2.16 中国电信短消息网关 SMGP 接
28、口协议规范（V3.1 ） 9 RecvTime 14 Octet String 短消息接收时间 7.2.28 SrcTermID 21 Octet String 短消息发送号码 7.2.19 DestTermID 21 Octet String 短消息接收号码 7.2.22 MsgLength 1 Integer 短消息长度 7.2.23 MsgContent MsgLength Octet String 短消息内容 7.2.24 选 参 数 Reserve 8 Octet String 保留 7.2.25 字段 数据类型 说明 参考 TP_pid TLV GSM 协议类型 7.3.2 TP_
29、udhi TLV GSM 协议类型 7.3.3 LinkID TLV 交易标识 7.3.4 SrcTermType TLV 短消息发送方的号码类型 7.3.14 SrcTermPseudo TLV 短消息发送方的伪码 7.3.15 SubmitMsgType TLV SP 发送的消息类型 7.3.12 可选参数 SPDealResult TLV SP 对消息的处理结果 7.3.13 5.2.2.3.2 Deliver_Resp 字段 长度（字节） 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 7.2.26 必选参数 Status 4 Integer 请求返回结
30、果 7.2.6 5.2.2.4 源 SMGW 向目的 SMGW 转发短消息的操作（Forward） 5.2.2.4.1 Forward 字段 长度（字节） 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 7.2.26 DestSMGWNo 6 Octet String 目的 SMGW 代码 7.2.29 SrcSMGWNo 6 Octet String 源 SMGW 代码 7.2.30 SMCNo 6 Octet String 短消息中心代码 7.2.31 MsgType 1 Integer 短消息类型 7.2.9 ReportFlag 1 Integer 状态
31、报告标志 7.2.32 Priority 1 Integer 短消息发送优先级 7.2.11 ServiceID 10 Octet String 业务代码 7.2.12 FeeType 2 Octet String 资费类型 7.2.13 必 选 参 数 FeeCode 6 Octet String 资费代码 7.2.14 10 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） FixedFee 6 Octet String 包月费/ 封顶费 7.2.15 MsgFormat 1 Integer 短消息格式 7.2.16 ValidTime 17 Octet String 有效时间 7
32、.2.17 AtTime 17 Octet String 定时发送时间 7.2.18 SrcTermID 21 Octet String 短消息发送用户号码 7.2.19 DestTermID 21 Octet String 短消息接收用户号码 7.2.22 ChargeTermID 21 Octet String 计费用户号码 7.2.20 MsgLength 1 Integer 短消息长度 7.2.23 MsgContent MsgLength Octet String 短消息内容 7.2.24 Reserve 8 Octet String 保留 7.2.25 字段 数据类型 说明 参考
33、TP_pid TLV GSM 协议类型 7.3.2 TP_udhi TLV GSM 协议类型 7.3.3 LinkID TLV 交易标识 7.3.4 ChargeUserType TLV 计费用户类型 7.3.5 NodesCount TLV 经过的网关数量 7.3.16 MsgSrc TLV 信息内容的来源 7.3.17 ChargeTermPseudo TLV 计费用户的伪码 7.3.7 SrcTermPseudo TLV 短消息发送方的伪码 7.3.14 DestTermPseudo TLV 短消息接收方的伪码 7.3.15 SrcType TLV 传递给 SP 的源号码的类型 7.3.
34、18 PkTotal TLV 相同 MsgID 的消息总条数 7.3.10 PkNumber TLV 相同 MsgID 的消息序号 7.3.11 SubmitMsgType TLV SP 发送的消息类型 7.3.12 SPDealResult TLV SP 对消息的处理结果 7.3.13 可选参数 MServiceID TLV 业务代码（用于移动网业务） 7.3.19 5.2.2.4.2 Forward_Resp 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） 11 字段 长度（字节） 数据类型 说明 参考 MsgID 10 Octet String SMGW 产生的短消息流水号 7
35、.2.26 必选参数 Status 4 Integer 请求返回结果 7.2.6 字段 数据类型 说明 参考 PkTotal TLV 相同 MsgID 的消息总条数 7.3.10 可选参数 PkNumber TLV 相同 MsgID 的消息序号 7.3.11 5.2.2.5 链路检测操作（Active_Test） 本操作仅适用于通信双方采用长连接通信方式时用于保持连接。 5.2.2.5.1 Active_Test 无消息体。 5.2.2.5.2 Active_Test_Resp 无消息体。 5.2.2.6 请求关闭连接的操作（Exit） Exit 操作的目的是客户端或服务器端基于某些原因决定拆
36、除当前的应用层连接而发起的操作。此操作完成后客户端与服务器端的应用层连接被释放，此后通信时应由客户端重新发起 Login 操作。 5.2.2.6.1 Exit 无消息体。 5.2.2.6.2 Exit_Resp 无消息体。 5.2.2.7 SP 向 SMGW 查询短消息发送状态的操作（Query，可选） 5.2.2.7.1 Query 字段 长度 （字节） 数据类型 说明 参考 QueryTime 8 Octet String 查询时间 7.2.33 QueryType 1 Integer 查询类别 7.2.34 必选参数 QueryCode 10 Octet String 查询码 7.2.3
37、5 5.2.2.7.2 Query_Resp 字段 长度 （字节） 数据类型 说明 参考 QueryTime 8 Octet String 查询时间 7.2.33 QueryType 1 Integer 查询类别 7.2.34 QueryCode 10 Octet String 查询码（业务类型） 7.2.35 必选参数 MT_TLMsg 4 Integer 接收短消息总数 7.2.36 12 中国电信短消息网关 SMGP 接口协议规范（V3.1 ） MT_Tlusr 4 Integer 接收用户总数 7.2.37 MT_Scs 4 Integer 成功转发数量 7.2.38 MT_WT 4
38、Integer 待转发数量 7.2.39 MT_FL 4 Integer 转发失败数量 7.2.40 MO_Scs 4 Integer 成功送达数量 7.2.41 MO_WT 4 Integer 待送达数量 7.2.42 MO_FL 4 Integer 送达失败数量 7.2.43 Reverse 8 Octet String 保留 7.2.25 6 SMGP 扩展协议 6.1 SMGP 协议扩展计费接口 SMGP 协议扩展计费接口在 SMGP 协议的基础上扩展了三种操作： （1 ） Payment_Request 扣款请求 （2 ） Payment_Affirm 扣款确认 （3 ） Query_UserState 查询用户状态 6.1.1 消息头扩展 消息头部分主要扩展了请求标识（RequestID ） ，参考 7.1.2。 6.1.2 消息体扩展 6.1.2.1 扣款请求（Payme nt_
