中国电信〔2008〕1451 号
关于印发中国电信短消息
网关协议规范(V3.1)的通知
集团公司各省级分公司,股份公司并转各省级分公司:
为更好地适应全业务经营的需要,集团公司组织上海研究
院对 2005 年下发的中国电信短消息网关协议规范(V3.0)(中
国电信〔2005〕240 号)进行了修订,形成了《中国电信短消息
网关协议(SMGP)规范(V3.1),现印发你们,请参照执行。
二○○八年十二月五日
中国电信集团公司技术标准
Q/CT 2069-2008
2008-12-10 发布 2008-12-10 实施
中国电信集团公司
发布
保密等级:公开发行
中国电信短消息网关协议(SMGP)规范
(V3.1)
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 消息结构................................................................. 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 函数说明....................................... 38
A.1 基本要求................................................................ 38
A.1.1 安装.................................................................. 38
A.1.2 例子程序.............................................................. 38
A.1.3 操作系统平台要求...................................................... 38
A.2 API 数据结构说明(以 C 语言为例) ........................................ 38
A.2.1 接收短消息的返回数据结构(DeliverResp)............................... 38
A.2.2 获取群发短消息的返回数据结构(SendBatchResp)......................... 39
A.2.3 查询短消息网关的返回数据结构(QueryResp 可选) ........................ 39
A.3 API 函数说明 ............................................................ 39
II
A.3.1 初始化 API(InitSMGPAPI) ............................................. 39
A.3.2 发送单条短消息(SMGPSendSingle)...................................... 40
A.3.3 群发短消息(SMGPSendBatch)........................................... 40
A.3.4 获取群发短消息的结果(GetSendBatchResp)..............................41
A.3.5 接收短消息(SMGPDeliver)............................................. 42
A.3.6 检查短消息网关是否能够提供服务(CMMPActiveTest) ...................... 42
A.3.7 查询短消息流量(SMGPQuery 可选) ......................................42
A.4 配置 SMGP API ........................................................... 42
A.5 短消息的自动分割功能.................................................... 43
A.6 错误代码含义............................................................ 43
附 录 B 短消息群发功能的实现.............................................. 45
III
前 言
本规范是依据 SMGP 协议 V3.0 的相关内容,结合中国电信 C 网业务网络 SMS 的特点
进行编写,随着中国电信业务网络 SMS 的发展完善,还将制定后续的相关规范要求。
本规范规定了短消息网关与其它网元之间进行短消息传输的接口协议。
本标准共包含 3 部分:1、SMGP 基本协议;2、SMGP 协议扩展计费接口;3、SMGP
协议扩展电子商务接口。本文只描述了第 1 部分 SMGP 基本协议,第 2 部分和第 3 部分同
SMGP 协议 V2.0。
本标准由中国电信集团公司提出并归口。
本标准起草单位:中国电信股份有限公司上海研究院
本标准主要起草人:蒋力 施唯佳 葛敏 顾丽丽 周文君 王建