中国电信短消息网关协议（SMGP协议）（v1.3）.doc

中国电信集团公司企业标准 CT/T 1-2001 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 短消息网关（SMGP）协议 V1.3 2002-04-30发布 2002-04-30实施 中国电信集团公司 发布 目 录 前 言 3 1 适用范围 4 2 引用标准 4 3 缩略语 4 4 SMGP概述 4 4.1. SMGP功能 4 4.2. SMGP定义 4 4.3. SMGP通信流程 5 5 SMGP数据包定义 7 5.1. 数据包结构 7 5.2. 请求标识说明 7 5.3. 包体结构 8 6 编码说明 16 6.1. 短消息格式代码表 16 6.2. 收费类型代码表 16 6.3. 短消息状态表 16 6.4. Err错误代码表 17 6.5. Status错误代码表 17 7 基于SMGP协议的API函数 18 附录A 基于SMGP协议的API函数说明 19 (提示的附录) 19 A.1基本要求 19 A.2 API数据结构说明（以C语言为例） 20 A.3 API函数说明 22 A 3.7查询短消息流量（SMGPQuery可选） 26 A.4配置SMGP API 26 A.5短信的自动分割功能 27 A.6错误代码含义 28 前 言 本标准介绍综合信息系统短消息网关和内容提供商（CP）之间、短消息网关和短消息网关之间的通信协议。本协议简称SMGP(Short Message Gateway Protocol)。 本标准起草单位： 中国电信集团公司、中国电信集团公司上海研发中心 本标准主要起草人： 特别感谢：亚信科技中国有限公司在本协议制订过程中的大力支持和帮助。 适用范围 本协议适用于短消息网关开发商和短消息内容提供商。 引用标准 SMPP (Short Message Peer to Peer Protocol Specification) v3.3 缩略语 见总册 SMGP概述 SMGP功能 SMGP协议是内容提供商与短消息网关，以及短消息网关与短消息网关之间的通信协议。SMGP可以实现以下功能： 内容提供商向综合信息系统短消息用户发送短消息，例如邮件通知、天气预报等。 综合信息系统短消息用户向内容提供商点播信息，例如股票查询、航班信息等。 内容提供商以某个短消息用户的身份向综合信息系统短消息用户发送传情信息，例如图片传情、音乐传情等。 综合信息系统短消息用户发送的短消息通过短消息网关前转发送给异地的短消息用户。 SMGP定义 SMGP协议是一个基于数据包的交互式协议，底层通过TCP/IP协议传递数据。每个数据包都包含请求标识，代表数据包的用途。内容提供商与短消息网关或者短消息网关与短消息网关之间采用Client/Server方式交互信息，客户端向服务器端发送一个请求包，服务器端向客户端返回回应包。 客户端发送的所有请求包都包含一个唯一的序列号，服务器端返回的回应包也带有相应的序列号，以便客户识别这是哪一个请求的回应。 客户端和服务器端之间可以采用长连接或者短连接的方式通信。如果采用短连接，客户端必须以发送者、接收者或收发者的身份登录到服务器，通信完毕后断开连接。如果采用长连接，一旦认证通过建立连接，客户端与服务器端可以随时通信，在一定时间内两者之间没有发送合法的请求包，连接就中断。 SMGP通信流程 网关与CP之间通信连接采用端口号8890，网关与网关通信连接采用端口号8900。 SMGP登录模式 在SMGP协议的一个会话中客户端可以采用三种登录方式与服务器端相连：发送模式（send mode）、接收模式（receive mode）和收发模式（transmit mode）。在发送模式中客户端只能发送短消息、在接收模式中客户端只能接收短消息、在收发模式中客户端既可以发送也可以接收短消息。三种模式均可以采用长连接与短连接两种连接方式的一种，根据实际情况选择。 CP发送短消息 CP以发送者或者是收发者身份登录后，就可以发送短消息。CP可以不等待上一个短消息发送回应包，就发送下一个短消息。 CP SMGW login(send /transmit mode) login_resp submit(1) submit(2) submit_resp (1) submit_resp (2) exit exit_resp CP接收短消息 CP以接收者或者是收发者身份登录后，短消息网关就向CP发送短消息，短消息网关可以不等待上一个短消息回应包，就发送下一个短消息。 CP