中国电信CPSP开发接口-中国电信SMGP协议(V3.0.3).docVIP

目 录 1 适用范围 2 2 引用标准 3 3 缩略语 4 4 SMGP协议概述 5 4.1 定义 5 4.2 通信方式 5 4.3 协议应用及涉及的端口号 7 5 SMGP协议 10 5.1 数据类型 10 5.2 消息结构 10 6 参数定义 23 6.1 消息头参数描述 23 6.2 消息体必选参数描述 25 6.3 消息体可选参数描述 40 7 基于SMGP协议的API函数 47 附录A 基于SMGP协议的API函数说明(规范性附录) 48 A.1基本要求 48 A.2 API数据结构说明（以C语言为例） 49 A.3 API函数说明 51 A.4配置SMGP API 55 A.5短消息的自动分割功能 56 A.6错误代码含义 57 附录B 短消息群发功能的实现（资料性附录） 59 附录C 修改历史记录 59 前 言 本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议。 本标准是在SMGP协议V2.0的基础上，基于3G网络的短消息业务发展需求进行修订而成。 本标准共包含3部分：1、SMGP基本协议；2、SMGP协议扩展计费接口；3、SMGP协议扩展电子商务接口。本文只描述了第1部分SMGP基本协议，第2部分和第3部分同SMGP协议V2.0。 本标准起草单位：中国电信股份有限公司、中国电信股份有限公司上海研究院 本标准主要起草人：葛敏 周文君 顾丽丽 蒋力 董斌 施唯佳 适用范围 本协议适用于短消息网络上（固定网、移动网）短消息网关与其它网元之间进行短消息的传输。 本协议适用于短消息网关、相关网元设备开发商及内容提供商。 引用标准 下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其必威体育精装版版本适用于本文。 【1】Short Message Peer to Peer Protocol Specification 【2】中国电信CDMA短消息网关设备规范v1.0.1 【3】中国电信CDMA短消息网关测试规范v1.0.1 【4】中国电信综合业务管理平台ISMP接口规范_RC1.0.1_-SS接口 英文全名 中文全名 ESME External Short Message Entity 外部短消息实体 GNS Gateway Name Server 汇接网关 SP Service Provider 服务提供商 SMSC Short Message Service Center 短消息业务中心 SMGP Short Message Gateway Protocol 短消息网关协议 SMGW Short Message Gateway 短消息网关 SMPP Short Message Point to Point Protocol 短消息点到点协议 SMGP协议概述 定义 SMGP协议是SMGW与其它网元设备（除SMC外）进行短消息传输的接口协议。 非SMC网元设备向SMGW发送或从SMGW接收短消息，这些非SMC网元设备称为ESME。 通信方式 SMGW与ESME之间共有两种连接方式：长连接和短连接。所谓长连接，指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此TCP连接，即每次TCP连接只完成一对SMGP消息的发送。 长连接 通信双方以客户-服务器方式建立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所示： 短连接 通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。 通信双方之间的消息发送后等待T秒后未收到响应，应立即重发，再