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

中国电信企业标准CTCT/TSNRC1CP/SP开发-SMGPV3.0.3CP/SP开发-中国电信短消息网关协议（SMGP）2008-08发布2008-08实施中国电信集团公司CP/SP开发-短消息网关协议SNRC1CP/SP开发-SMGPV3.0.3-1-目录1适用范围............................................................................................................................22引用标准............................................................................................................................33缩略语................................................................................................................................44SMGP协议概述................................................................................................................54.1定义................................................................................................................................................54.2通信方式........................................................................................................................................54.3协议应用及涉及的端口号............................................................................................................75SMGP协议......................................................................................................................105.1数据类型......................................................................................................................................105.2消息结构......................................................................................................................................106参数定义..........................................................................................................................236.1消息头参数描述..........................................................................................................................236.2消息体必选参数描述..................................................................................................................256.3消息体可选参数描述..................................................................................................................407基于SMGP协议的API函数........................................................................................47附录A基于SMGP协议的API函数说明(规范性附录).................................................48A.1基本要求..........................................................................................................................................48A.2API数据结构说明（以C语言为例）...........................................................................................49A.3API函数说明...................................................................................................................................51A.4配置SMGPAPI................................................................................................................................55A.5短消息的自动分割功能...................................................................................................................56A.6错误代码含义..................................................................................................................................57附录B短消息群发功能的实现（资料性附录）................................................................59附录C修改历史记录............................................................................................................59短消息网关协议SNRC1SMGPV3.0.3-1-前言本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议。本标准是在SMGP协议V2.0的基础上，基于3G网络的短消息业务发展需求进行修订而成。本标准共包含3部分：1、SMGP基本协议；2、SMGP协议扩展计费接口；3、SMGP协议扩展电子商务接口。本文只描述了第1部分SMGP基本协议，第2部分和第3部分同SMGP协议V2.0。本标准起草单位：中国电信股份有限公司、中国电信股份有限公司上海研究院本标准主要起草人：葛敏周文君顾丽丽蒋力董斌施唯佳CP/SP开发-短消息网关协议SNRC1CP/SP开发-SMGPV3.0.3-2-1适用范围本协议适用于短消息网络上（固定网、移动网）短消息网关与其它网元之间进行短消息的传输。本协议适用于短消息网关、相关网元设备开发商及内容提供商。CP/SP开发-短消息网关协议SNRC1CP/SP开发-SMGPV3.0.3-3-2引用标准下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。【1】ShortMessagePeertoPeerProtocolSpecification【2】中国电信CDMA短消息网关设备规范v1.0.1【3】中国电信CDMA短消息网关测试规范v1.0.1【4】中国电信综合业务管理平台ISMP接口规范_RC1.0.1_-SS接口CP/SP开发-短消息网关协议SNRC1CP/SP开发-SMGPV3.0.3-4-3缩略语缩略语英文全名中文全名ESMEExternalShortMessageEntity外部短消息实体GNSGatewayNameServer汇接网关SPServiceProvider服务提供商SMSCShortMessageServiceCenter短消息业务中心SMGPShortMessageGatewayProtocol短消息网关协议SMGWShortMessageGateway短消息网关SMPPShortMessagePointtoPointProtocol短消息点到点协议CP/SP开发-短消息网关协议SNRC1CP/SP开发-SMGPV3.0.3-5-4SMGP协议概述4.1定义SMGP协议是SMGW与其它网元设备（除SMC外）进行短消息传输的接口协议。非SMC网元设备向SMGW发送或从SMGW接收短消息，这些非SMC网元设备称为ESME。4.2通信方式SMGW与ESME之间共有两种连接方式：长连接和短连接。所谓长连接，指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此TCP连接，即每次TCP连接只完成一对SMGP消息的发送。4.2.1长连接通信双方以客户-服务器方式建立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所示：CP/SP开发-短消息网关协议SNRC1CP/SP开发-SMGPV3.0.3-6-......建立TCP连接滑动窗口不大于WWSMGP消息1客户端服务器端SMGP消息2对SMGP消息1的响应对SMGP消息2的响应链路检测包链路检测包响应建立TCP连接链路检测包链路检测包响应拆除TCP连接......建立TCP连接图4.1长连接操作流程CP/SP开发-短消息网关协议SNRC