中国电信SMGP协议.doc

中国电信企业标准 CT CT T SN RC1 SMGP V3 0 2 中国电信 短消息网关协议 SMGP 2008 03 发布 2008 03 实施 中 国 电 信 集 团 公 司 目 录 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 参数定义 25 6 1 消息头参数描述 25 6 2 消息体必选参数描述 27 6 3 消息体可选参数描述 42 7 基于 SMGP 协议的 API 函数 48 附录 A 基于 SMGP 协议的 API 函数说明 规范性附录 49 A 1 基本要求 49 A 2 API 数据结构说明 以 C 语言为例 50 A 3 API 函数说明 52 A 4 配置 SMGP API 56 A 5 短消息的自动分割功能 57 A 6 错误代码含义 57 附录 B 短消息群发功能的实现 资料性附录 60 附录 C 修改历史记录 60 前 言 本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议 本标准是在 SMGP 协议 V2 0 的基础上 基于 3G 网络的短消息业务发展需求进行修订而成 本标准共包含 3 部分 1 SMGP 基本协议 2 SMGP 协议扩展计费接口 3 SMGP 协议扩展电子 商务接口 本文只描述了第 1 部分 SMGP 基本协议 第 2 部分和第 3 部分同 SMGP 协议 V2 0 本标准起草单位 中国电信股份有限公司 中国电信股份有限公司上海研究院 本标准主要起草人 葛敏 周文君 顾丽丽 蒋力 董斌 施唯佳 顾震宇 1 适用范围 本协议适用于短消息网络上 固定网 移动网 短消息网关与其它网元之间进行短消息的传输 本协议适用于短消息网关 相关网元设备开发商及内容提供商 2 引用标准 下列文件通过本文的参考而成为本规范的条款 凡是注日期的参考文件 其随后所有的修改单 不包括勘误的内容 或修订版均不适用于本文 凡是不注日期的参考文件 其最新版本适用于本文 1 Short Message Peer to Peer Protocol Specification 2 中国电信 CDMA 短消息网关设备规范 v1 0 0 3 中国电信 CDMA 短消息网关测试规范 v1 0 0 4 中国电信综合业务管理平台 ISMP 接口规范 V1 0 0 3 缩略语 缩略语 英文全名 中文全名 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 短消息点到点协议 4 SMGP 协议概述 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 所示 建 立 TCP连 接 滑动窗口不大于 W W SMGP 消息 1 客户端 服务器端 SMGP 消息 2 对 SMGP 消息 1 的响应 对 SMGP 消息 2 的响应 链路检测包 链路检测包响应 建立 TCP 连接 链路检测包 链路检测包响应 拆除 TCP 连接 建 立 TCP连 接 图 4 1 长连接操作流程 4 2 2 短连接 通信双方以客户 服务器方式建立 TCP 连接 应答与请求在同一个连接中完成 系统采用客户 服 务器模式 操作以客户端驱动方式发起连接请求 完成一次操作后关闭此连接 通信双方之间的消息发送后等待 T 秒后未收到响应 应立即重发 再连续发送 N 1 次后仍未得到 响应则停发 现阶段建议取值为 T 60 秒 N 3 短连接的操作流程举例如图 2 所示 4 3 协议应用及涉及的端口号 SMGP 协议在中国电信中的应用主要体现在两类短消息业务上 一类是固定网短消息业务 另一 对 SMGP 消息 1 的响应 SMGP 消息 1 建立 TCP 连接 拆除 TCP 连接 SMGP 消息 2 对 SMGP 消息 2 的响应 建立 TCP 连接 拆除 TCP 连接 建 立 TCP连 接 客户端 服务器端 图 4 2 短连接操作流程 类是移动网短消息业务 4 3 1 固定网短消息业务 图 4 3 SMGP及 SMGP扩 展 计 费 接 口 SMGP SMGP SMGP SP SMC 预 付 费 平台 固 定 终 端 PHS 家 加 e SMC 预 付 费 平 台 SP 一 级 SMGW 二 级 SMGW 固 定 网 PHS PSTN 固 定 终 端 PHS 家 加 e 固 定 网 PHS PSTN 二 级 SMGW SP SMGP扩 展计 费 接 口 SMGP扩 展计 费 接 口 SMGP及 SMGP扩 展 计 费 接 口 固定网短消息业务系统结构简图 固定网短消息业务系统结构简图如图 3 所示 SMGP 协议在固网短消息系统中应用情况如下 1 二级 SMGW 与 SP 二级 SMGW 与 SP 之间采用 SMGP 协议进行短消息的传输 端口号为 8890 二级 SMGW 为服务 器端 SP 为客户端 2 二级 SMGW 与一级 SMGW 二级 SMGW 与一级 SMGW 之间采用 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 协议扩展计费接口 参见 SMGP V2 0 进行计费信 息的传输 端口号为 9100 预付费平台作为服务器端 二级 SMGW 作为客户端 4 3 2 移动网短消息业务 移动网短消息业务系统结构简图如图 4 所示 SMGP 协议在移动网短消息系统中应用情况如下 1 SMGW 与 SP SMGW 与 SP 之间采用 SMGP 协议进行短消息的传输 端口号为 8890 SMGW 为服务器端 SP 为客户端 2 SMGW 与 SMGW SMGW 与 SMGW 之间采用 SMGP 协议进行短消息的传输 端口号为 8900 SMGW 与 SMGW 互为客户 服务器端 3 SMGW 与 GNS SMGW 与 GNS 之间采用 SMGP 协议进行消息传输 端口号为 8901 SMGW 为服务器端 GNS 为客户端 GNS SMGWSMGW SMC SMC 图 4 4 移动网短消息业务系统结构简图构图 SMGP SMGP SPSP SMGPSMGPSMGP 移动网 移动网 移动网终端 移动网终端 5 SMGP 协议 5 1 数据类型 5 1 1 基本数据类型 Integer 无符号整数 Octet String 不强制以 0 x00 结尾的定长字符串 当位数不足时 在不明 确注明的情况下 应左对齐 右补 0 x00 在明确注明的情 况下 以该字段的明确注明为准 5 1 2 可选参数 可选参数采用 TLV Tag Length Value 形式定义 每个可选参数的 Tag Length Value 的 定义见 6 3 节 字段 长度 字节 数据类型 说明 Tag 2 Integer 字段的标签 用于唯一标识可选 参数 Length 2 Integer 字段的长度 Value 可变长度 可变类型 字段内容 5 2 消息结构 项目 说明 Message Header 消息头 所有消息公共包头 Message Body 消息体 5 2 1 消息头结构 字段 长度 字节 数据类型 说明 参考 PacketLength 4 Integer 数据包长度 6 1 1 RequestID 4 Integer 请求标识 6 1 2 SequenceID 4 Integer 消息流水号 6 1 3 5 2 2 消息体结构 5 2 2 1 登录操作 Login Login 操作的目的是客户端向服务器端注册作为一个合法客户端身份 若注册成功后即建立了应 用层的连接 此后客户端可以与此服务器端进行消息的接收和发送 服务器端以 Login Resp 消息响应客户端的请求 5 2 2 1 1Login 字段 长度 字节 数据类型 说明 参考 ClientID 8 Octet String 客户端用来登录服务器端的 用户账号 6 2 1 AuthenticatorClie nt 16 Octet String 客户端认证码 用来鉴别客 户端的合法性 6 2 2 LoginMode 1 Integer 客户端用来登录服务器端的 登录类型 6 2 3 TimeStamp 4 Integer 时间戳 6 2 4 必 选 参 数 ClientVersion 1 Integer 客户端支持的协议版本号 6 2 5 5 2 2 1 2Login Resp 字段 长度 字节 数据类型 说明 参考 Status 4 Integer 请求返回结果 6 2 6必 选 参 数 AuthenticatorSer ver 16 Octet String 服务器端返回给客户端的认 证码 6 2 7 ServerVersion 1 Integer 服务器端支持的最高版本号 6 2 8 5 2 2 2 SP 向 SMGW 提交短消息的操作 Submit 5 2 2 2 1Submit 字段 长度 字节 数据类型 说明 参考 MsgType 1 Integer 短消息类型 6 2 9 NeedReport 1 Integer SP 是否要求返回状态报告 6 2 10 Priority 1 Integer 短消息发送优先级 6 2 11 ServiceID 10 Octet String 业务代码 6 2 12 FeeType 2 Octet String 收费类型 6 2 13 FeeCode 6 Octet String 资费代码 6 2 14 FixedFee 6 Octet String 包月费 封顶费 6 2 15 MsgFormat 1 Integer 短消息格式 6 2 16 ValidTime 17 Octet String 短消息有效时间 6 2 17 AtTime 17 Octet String 短消息定时发送时间 6 2 18 SrcTermID 21 Octet String 短信息发送方号码 6 2 19 ChargeTermID 21 Octet String 计费用户号码 6 2 20 DestTermIDCoun t 1 Integer 短消息接收号码总数 6 2 21 DestTermID 21 Dest TermCo unt Octet String 短消息接收号码 6 2 22 MsgLength 1 Integer 短消息长度 6 2 23 MsgContent MsgLengt h Octet String 短消息内容 6 2 24 必 选 参 数 Reserve 8 Octet String 保留 6 2 25 字段 数据类型 说明 参考 TP pid TLV GSM 协议类型 6 3 2 TP udhi TLV GSM 协议类型 6 3 3 LinkID TLV 交易标识 6 3 4 MsgSrc TLV 信息内容的来源 6 3 17 ChargeUserType TLV 计费用户类型 6 3 5 可 选 参 数 ChargeTermType TLV 计费用户的号码类型 6 3 6 ChargeTermPseudo TLV 计费用户的伪码 6 3 7 DestTermType TLV 短消息接收方号码的类型 6 3 8 DestTermPseudo TLV 短消息接收方的伪码 6 3 9 PkTotal TLV 相同 MsgID 的消息总条数 6 3 10 PkNumber TLV 相同 MsgID 的消息序号 6 3 11 SubmitMsgType TLV SP 发送的消息类型 6 3 12 SPDealResult TLV SP 对消息的处理结果 6 3 13 MServiceID TLV 业务代码 用于移动网业务 6 3 19 短信平台支持短信的群发功能 关于短信群发功能的实现请参阅 附录 B 短消息群发功能的实 现 5 2 2 2 2Submit Resp 字段 长度 字节 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 6 2 26必 选 参 数 Status 4 Integer 请求返回结果 6 2 6 5 2 2 3 SMGW 向 SP 下发短消息的操作 Deliver 5 2 2 3 1Deliver 字段 长度 字节 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 6 2 26 IsReport 1 Integer 是否为状态报告 6 2 27 MsgFormat 1 Integer 短消息格式 6 2 16 RecvTime 14 Octet String 短消息接收时间 6 2 28 SrcTermID 21 Octet String 短消息发送号码 6 2 19 DestTermID 21 Octet String 短消息接收号码 6 2 22 MsgLength 1 Integer 短消息长度 6 2 23 MsgContent MsgLengt h Octet String 短消息内容 6 2 24 必 选 参 数 Reserve 8 Octet String 保留 6 2 25 可 字段 数据类型 说明 参考 TP pid TLV GSM 协议类型 6 3 2 TP udhi TLV GSM 协议类型 6 3 3 LinkID TLV 交易标识 6 3 4 SrcTermType TLV 短消息发送方的号码类型 6 3 14 SrcTermPseudo TLV 短消息发送方的伪码 6 3 15 SubmitMsgType TLV SP 发送的消息类型 6 3 12 选 参 数 SPDealResult TLV SP 对消息的处理结果 6 3 13 5 2 2 3 2Deliver Resp 字段 长度 字节 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 6 2 26必 选 参 数 Status 4 Integer 请求返回结果 6 2 6 5 2 2 4 源 SMGW 向目的 SMGW 转发短消息的操作 Forward 5 2 2 4 1Forward 字段 长度 字节 数据类型 说明 参考 MsgID 10 Octet String 短消息流水号 6 2 26 DestSMGWNo 6 Octet String 目的 SMGW 代码 6 2 29 SrcSMGWNo 6 Octet String 源 SMGW 代码 6 2 30 SMCNo 6 Octet String 短消息中心代码 6 2 31 MsgType 1 Integer 短消息类型 6 2 9 ReportFlag 1 Integer 状态报告标志 6 2 32 Priority 1 Integer 短消息发送优先级 6 2 11 ServiceID 10 Octet String 业务代码 6 2 12 必 选 参 数 FeeType 2 Octet String 资费类型 6 2 13 FeeCode 6 Octet String 资费代码 6 2 14 FixedFee 6 Octet String 包月费 封顶费 6 2 15 MsgFormat 1 Integer 短消息格式 6 2 16 ValidTime 17 Octet String 有效时间 6 2 17 AtTime 17 Octet String 定时发送时间 6 2 18 SrcTermID 21 Octet String 短消息发送用户号码 6 2 19 DestTermID 21 Octet String 短消息接收用户号码 6 2 22 ChargeTermID 21 Octet String 计费用户号码 6 2 20 MsgLength 1 Integer 短消息长度 6 2 23 MsgContent MsgLengt h Octet String 短消息内容 6 2 24 Reserve 8 Octet String 保留 6 2 25 字段 数据类型 说明 参考 TP pid TLV GSM 协议类型 6 3 2 TP udhi TLV GSM 协议类型 6 3 3 LinkID TLV 交易标识 6 3 4 ChargeUserType TLV 计费用户类型 6 3 5 NodesCount TLV 经过的网关数量 6 3 16 MsgSrc TLV 信息内容的来源 6 3 17 ChargeTermPseudo TLV 计费用户的伪码 6 3 7 SrcTermPseudo TLV 短消息发送方的伪码 6 3 14 DestTermPseudo TLV 短消息接收方的伪码 6 3 15 SrcType TLV 传递给 SP 的源号码的类型 6 3 18 PkTotal TLV 相同 MsgID 的消息总条数 6 3 10 PkNumber TLV 相同 MsgID 的消息序号 6 3 11 SubmitMsgType TLV SP 发送的消息类型 6 3 12 SPDealResult TLV SP 对消息的处理结果 6 3 13 可 选 参 数 MServiceID TLV 业务代码 用于移动网业务 6 3 19 5 2 2 4 2Forward Resp 字段 长度 字节 数据类型 说明 参考 MsgID 10 Octet String SMGW 产生的短消息流水号 6 2 26必 选 参 数 Status 4 Integer 请求返回结果 6 2 6 字段 数据类型 说明 参考 PkTotal TLV 相同 MsgID 的消息总条数 6 3 10 可 选 参 数 PkNumber TLV 相同 MsgID 的消息序号 6 3 11 5 2 2 5 链路检测操作 Active Test 本操作仅适用于通信双方采用长连接通信方式时用于保持连接 5 2 2 5 1Active Test 无消息体 5 2 2 5 2Active Test Resp 无消息体 5 2 2 6 请求关闭连接的操作 Exit Exit 操作的目的是客户端或服务器端基于某些原因决定拆除当前的应用层连接而发起的操作 此 操作完成后客户端与服务器端的应用层连接被释放 此后通信时应由客户端重新发起 Login 操作 5 2 2 6 1Exit 无消息体 5 2 2 6 2Exit Resp 无消息体 5 2 2 7 SP 向 SMGW 查询短消息发送状态的操作 Query 可选 5 2 2 7 1Query 字段 长度 字节 数据类型 说明 参考 QueryTime 8 Octet String 查询时间 6 2 33 QueryType 1 Integer 查询类别 6 2 34 必 选 参 数 QueryCode 10 Octet String 查询码 6 2 35 5 2 2 7 2Query Resp 字段 长度 字节 数据类型 说明 参考 QueryTime 8 Octet String 查询时间 6 2 33 QueryType 1 Integer 查询类别 6 2 34 QueryCode 10 Octet String 查询码 业务类型 6 2 35 MT TLMsg 4 Integer 接收短消息总数 6 2 36 MT Tlusr 4 Integer 接收用户总数 6 2 37 MT Scs 4 Integer 成功转发数量 6 2 38 MT WT 4 Integer 待转发数量 6 2 39 MT FL 4 Integer 转发失败数量 6 2 40 MO Scs 4 Integer 成功送达数量 6 2 41 MO WT 4 Integer 待送达数量 6 2 42 MO FL 4 Integer 送达失败数量 6 2 43 必 选 参 数 Reverse 8 Octet String 保留 6 2 25 5 2 2 8 SMGW 向 GNS 查询终端路由的操作 Query TE Route 可选 5 2 2 8 1Query TE Route 字段 长度 字节 数据类型 说明 参考 必 SrcGatewayID 6 Octet String 源网关代码 6 2 44 选 参 数 QueryTermID 21 Octet String 查询号码 6 2 45 5 2 2 8 2Query TE Route Resp 字段 长度 字节 数据类型 说明 参考 Status 4 Integer 请求返回结果 6 2 6 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 TermRangeID 10 Octet String 路由号码段 6 2 50 ProvinceCode 4 Octet String 终端所属省代号 6 2 51 UserType 1 Integer 用户类型 该字段保留 6 2 52 必 选 参 数 Time 14 Octet String 时间戳 6 2 53 5 2 2 9 SMGW 向 GNS 查询 SP 路由的操作 Query SP Route 可选 5 2 2 9 1Query SP Route 字段 长度 字节 数据类型 说明 参考 SrcGatewayID 6 Octet String 源网关代码 6 2 44必 选 参 数 QueryTermID 21 Octet String 查询号码 6 2 45 5 2 2 9 2Query SP Route Resp 字段 长度 字节 数据类型 说明 参考 Status 4 Integer 请求返回结果 6 2 6必 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 SPID 8 Octet String SP 的企业代码 6 2 54 SPCode 21 Octet String SP 的服务代码 6 2 55 SPAccessType 1 Integer SP 接入类型 6 2 56 SPType 1 Integer SP 类型 6 2 57 选 参 数 Time 14 Octet String 时间戳 6 2 53 5 2 2 10 SMGW 向 GNS 获取所有终端路由的操作 Get All TE Route 可选 5 2 2 10 1 Get All TE Route 字段 长度 字节 数据类型 说明 参考 SrcGatewayID 6 Octet String 源网关代码 6 2 44 RouteType 4 Octet String 路由类型 6 2 58必 选 参 数 LastRouteID 4 Integer 已经接收的上一条路由编号 6 2 59 5 2 2 10 2 Get All TE Route Resp 字段 长度 字节 数据类型 说明 参考 Status 4 Integer 请求返回结果 6 2 6 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 TermRangeID 10 Octet String 路由号码段 6 2 50 ProvinceCode 4 Octet String 终端所属省代号 6 2 51 必 选 参 数 UserType 1 Integer 用户类型 该字段保留 6 2 52 RouteTotal 4 Integer 返回路由总数 6 2 60 RouteNumber 4 Integer 当前返回的路由序号 6 2 61 Time 14 Octet String 时间戳 6 2 53 5 2 2 11 SMGW 向 GNS 获取所有 SP 路由的操作 Get All SP Route 可 选 5 2 2 11 1 Get All SP Route 字段 长度 字节 数据类型 说明 参考 SrcGatewayID 6 Octet String 源网关代码 6 2 44 RouteType 4 Octet String 路由类型 6 2 58必 选 参 数 LastRouteID 4 Integer 已经接收的上一条路由编号 6 2 59 5 2 2 11 2 Get All SP Route Resp 字段 长度 字节 数据类型 说明 参考 Status 4 Integer 请求返回结果 6 2 6 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 SPID 8 Octet String SP 的企业代码 6 2 54 SPCode 21 Octet String SP 的服务代码 6 2 55 SPAccessType 1 Integer SP 接入类型 6 2 56 SPType 1 Integer SP 类型 6 2 57 RouteTotal 4 Integer 返回路由总数 6 2 60 RouteNumber 4 Integer 当前返回的路由序号 6 2 61 必 选 参 数 Time 14 Octet String 时间戳 6 2 53 5 2 2 12 SMGW 向 GNS 更新终端路由的操作 Update TE Route 可选 5 2 2 12 1 Update TE Route 字段 长度 字节 数据类型 说明 参考 UpdateType 1 Integer 更新类型 6 2 62 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 TermRangeID 10 Octet String 路由号码段 6 2 50 ProvinceCode 4 Octet String 终端所属省代号 6 2 51 必 选 参 数 UserType 1 Integer 用户类型 该字段保留 6 2 52 5 2 2 12 2 Update TE Route Resp 字段 长度 字节 数据类型 说明 参考 Status 4 Integer 请求返回结果 6 2 6 RouteID 4 Integer 路由编号 6 2 46必 选 参 数 Time 14 Octet String 时间戳 6 2 53 5 2 2 13 SMGW 向 GNS 更新 SP 路由的操作 Update SP Route 可选 5 2 2 13 1 Update SP Route 字段 长度 字节 数据类型 说明 参考 UpdateType 1 Integer 更新类型 6 2 62必 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 SPID 8 Octet String SP 的企业代码 6 2 54 SPCode 21 Octet String SP 的服务代码 6 2 55 SPAccessType 1 Integer SP 接入类型 6 2 56 选 参 数 SPType 1 Integer SP 类型 6 2 57 5 2 2 13 2 Update SP Route Resp 字段 长度 字节 数据类型 说明 参考 Status 4 Integer 请求返回结果 6 2 6 RouteID 4 Integer 路由编号 6 2 46必 选 参 数 Time 14 Octet String 时间戳 6 2 53 5 2 2 14 GNS 向 SMGW 更新终端路由的操作 Push Update TE Route 可选 5 2 2 14 1 Push Update TE Route 字段 长度 字节 数据类型 说明 参考 UpdateType 1 Integer 更新类型 6 2 62 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 TermRangeID 10 Octet String 路由号码段 6 2 50 ProvinceCode 4 Octet String 终端所属省代号 6 2 51 UserType 1 Integer 用户类型 该字段保留 6 2 52 必 选 参 数 Time 14 Octet String 时间戳 6 2 53 5 2 2 14 2 Push Update TE Route Resp 字段 长度 字节 数据类型 说明 参考 必 选 参 数 Status 4 Integer 请求返回结果 6 2 6 5 2 2 15 GNS 向 SMGW 更新 SP 路由的操作 Push Update SP Route 可选 5 2 2 15 1 Push Update SP Route 字段 长度 字节 数据类型 说明 参考 UpdateType 1 Integer 更新类型 6 2 62 RouteID 4 Integer 路由编号 6 2 46 DestGatewayID 6 Octet String 目标网关代码 6 2 47 DestGatewayIP 15 Octet String 目标网关 IP 地址 6 2 48 DestGatewayPort 2 Integer 目标网关 IP 端口 6 2 49 SPID 8 Octet String SP 的企业代码 6 2 54 SPCode 21 Octet String SP 的服务代码 6 2 55 SPAccessType 1 Integer SP 接入类型 6 2 56 SPType 1 Integer SP 类型 6 2 57 必 选 参 数 Time 14 Octet String 时间戳 6 2 53 5 2 2 15 2 Push Update SP Route Resp 字段 长度 字节 数据类型 说明 参考 必 选 参 数 Status 4 Integer 请求返回结果 6 2 6 6 参数定义 6 1 消息头参数描述 6 1 1 PacketLength SMGP 数据包长度 指包头和包体的长度之和 单位是 字节 6 1 2 RequestId 请求标识表示 SMGP 数据包的类型 请求包的请求标识和应答包的请求标识一一对应 SMGP 协 议的请求标识定义如下 请求名称 请求标识 说明 Login 0 x00000001 客户端登录 Login Resp 0 x80000001 客户端登录应答 Submit 0 x00000002 提交短消息 Submit Resp 0 x80000002 提交短消息应答 Deliver 0 x00000003 下发短消息 Deliver Resp 0 x80000003 下发短消息应答 Active Test 0 x00000004 链路检测 Active Test Resp 0 x80000004 链路检测应答 Forward 0 x00000005 短消息前转 Forward Resp 0 x80000005 短消息前转应答 Exit 0 x00000006 退出请求 Exit Resp 0 x80000006 退出应答 Query 0 x00000007 SP 统计查询 Query Resp 0 x80000007 SP 统计查询应答 Query TE Route 0 x00000008 查询 TE 路由 Query TE Route Re sp 0 x80000008 查询 TE 路由应答 Query SP Route 0 x00000009 查询 SP 路由 Query SP Route Re sp 0 x80000009 查询 SP 路由应答 Payment Request 0 x0000000A 扣款请求 用于预付费系统 参见增值业务计费方 案 Payment Request Re sp 0 x8000000A 扣款请求响应 用于预付费系统 参见增值业务计 费方案 下同 Payment Affirm 0 x0000000B 扣款确认 用于预付费系统 参见增值业务计费方 案 Payment Affirm Res p 0 x8000000B 扣款确认响应 用于预付费系统 参见增值业务计 费方案 Query UserState 0 x0000000C 查询用户状态 用于预付费系统 参见增值业务计 费方案 Query UserState Res p 0 x8000000C 查询用户状态响应 用于预付费系统 参见增值业 务计费方案 Get All TE Route 0 x0000000D 获取所有终端路由 Get All TE Route Resp 0 x8000000D 获取所有终端路由应答 Get All SP Route 0 x0000000E 获取所有 SP 路由 Get All SP Route R esp 0 x8000000E 获取所有 SP 路由应答 Update TE Route 0 x0000000F SMGW 向 GNS 更新终端路由 Update TE Route R esp 0 x8000000F SMGW 向 GNS 更新终端路由应答 Update SP Route 0 x00000010 SMGW 向 GNS 更新 SP 路由 Update SP Route R esp 0 x80000010 SMGW 向 GNS 更新 SP 路由应答 Push Update TE Ro ute 0 x00000011 GNS 向 SMGW 更新终端路由 Push Update TE Ro ute Resp 0 x80000011 GNS 向 SMGW 更新终端路由应答 Push Update SP Ro ute 0 x00000012 GNS 向 SMGW 更新 SP 路由 Push Update SP Ro ute Resp 0 x80000012 GNS 向 SMGW 更新 SP 路由应答 其它 保留 6 1 3 SequenceId SMGP 消息流水号 用来匹配请求数据包和应答数据包 应答数据包的流水号字段必须与请求包的流水号字段一致 流水号字段由请求包发起方分配 取值范围为 0 x00000000 0 xFFFFFFFF 顺序累加 步长为 1 循环使用 6 2 消息体必选参数描述 6 2 1 ClientID 客户端用来登录服务器端的用户账号 当客户端为 SP 时 用户帐号为 SP 服务代码 当客户端为 SMGW 时 用户帐号为 SMGW 代码 当客户端为 GNS 时 用户帐号为 GNS 代码 6 2 2 AuthenticatorClient 客户端认证码 用来鉴别客户端的合法性 其值通过单向 MD5 hash 计算得出 表示如下 AuthenticatorClient MD5 ClientID 7 字节的二进制 0 0 x00 Shared secret Timestamp Shared secret 由服务器端与客户端事先商定 最长 15 字节 此处 Timestamp 格式为 MMDDHHMMSS 月日时分秒 经 TimeStamp 字段值转换成字符串 转换后右对齐 左补 0 x30 得到 例如 3 月 1 日 0 时 0 分 0 秒 TimeStamp 字段值为 0 x11F0E540 此处为 0301000000 6 2 3 LoginMode 客户端用来登录服务器端的登录模式 0 发送短消息 send mode 1 接收短消息 receive mode 2 收发短消息 transmit mode 其它保留 6 2 4 TimeStamp 时间戳 例如 3 月 1 日 0 时 0 分 0 秒 用于 MD5 计算时为 0301000000 此处转换为整型数即为 11F0E540 6 2 5 ClientVersion 客户端支持的协议版本号 高 4bit 表示主版本号 低 4bit 表示次版本号 例如 0 x13 表示协议版本号为 1 3 6 2 6 Status 请求返回结果 响应包用来向请求包返回成功信息或者失败原因 SMGP 协议的结果码定义如下 代码 含义 0 成功 1 系统忙 2 超过最大连接数 3 9 保留 10 消息结构错 11 命令字错 12 序列号重复 13 19 保留 20 IP 地址错 21 认证错 22 版本太高 23 29 保留 30 非法消息类型 MsgType 31 非法优先级 Priority 32 非法资费类型 FeeType 33 非法资费代码 FeeCode 34 非法短消息格式 MsgFormat 35 非法时间格式 36 非法短消息长度 MsgLength 37 有效期已过 38 非法查询类别 QueryType 39 路由错误 40 非法包月费 封顶费 FixedFee 41 非法更新类型 UpdateType 42 非法路由编号 RouteId 43 非法服务代码 ServiceId 44 非法有效期 ValidTime 45 非法定时发送时间 AtTime 46 非法发送用户号码 SrcTermId 47 非法接收用户号码 DestTermId 48 非法计费用户号码 ChargeTermId 49 非法 SP 服务代码 SPCode 50 55 其它用途 56 非法源网关代码 SrcGatewayID 57 非法查询号码 QueryTermID 58 没有匹配路由 59 非法 SP 类型 SPType 60 非法上一条路由编号 LastRouteID 61 非法路由类型 RouteType 62 非法目标网关代码 DestGatewayID 63 非法目标网关 IP DestGatewayIP 64 非法目标网关端口 DestGatewayPort 65 非法路由号码段 TermRangeID 66 非法终端所属省代码 ProvinceCode 67 非法用户类型 UserType 68 本节点不支持路由更新 69 非法 SP 企业代码 SPID 70 非法 SP 接入类型 SPAccessType 71 路由信息更新失败 72 非法时间戳 Time 73 非法业务代码 MServiceID 74 SP 禁止下发时段 75 SP 发送超过日流量 76 SP 帐号过有效期 112 116 其它用途 128 255 厂家自定义 其它 保留 6 2 7 AuthenticatorServer Login 服务器端返回给客户端的认证码 当客户端认证出错时 此项为空 其值通过单向 MD5 hash 计算得出 表示如下 AuthenticatorServer MD5 Status AuthenticatorClient Shared secret Shared secret 由服务器端与客户端事先商定 最长 15 字节 AuthenticatorClient 为客户端发送给服务 器端的 Login 中的值 参见 6 2 2 节 6 2 8 ServerVersion 服务器端支持的最高版本号 高 4bit 表示主版本号 低 4bit 表示次版本号 例如 0 x13 表示协议版本号 1 3 6 2 9 MsgType 短消息类型 对于回执消息该字段无效 对于文本短消息 该字段表示短消息的消息流向 0 MO 消息 终端发给 SP 6 MT 消息 SP 发给终端 包括 WEB 上发送的点对点短消息 7 点对点短消息 其它保留 6 2 10 NeedReport 是否要求返回状态报告 0 不要求返回状态报告 1 要求返回状态报告 其它保留 6 2 11 Priority 短消息发送优先级 0 低优先级 1 普通优先级 2 较高优先级 3 高优先级 其它保留 6 2 12 ServiceID 业务代码 用于固定网业务 对于 MO 消息或点对点短消息 该字段无效 对于 MT 消息 该字段表示业务代码 是该条短消息所属的业务类别 由数字 字母和符号组合 而成 对于从 WEB 上发送的点对点短消息 要求业务代码为 PC2P 其它业务代码由 SP 自定义 6 2 13 FeeType 对计费用户采取的收费类型 对于 MO 消息或点对点短消息 该字段无效 对于 MT 消息 该字段用法如下 00 免费 此时 FixedFee 和 FeeCode 无效 01 按条计信息费 此时 FeeCode 表示每条费用 FixedFee 无效 02 按包月收取信息费 此时 FeeCode 无效 FixedFee 表示包月费用 03 按封顶收取信息费 若按条收费的费用总和达到或超过封顶费后 则按照封顶费用收取信息 费 若按条收费的费用总和没有达到封顶费用 则按照每条费用总和收取信息费 FeeCode 表示每条 费用 FixedFee 表示封顶费用 其它保留 6 2 14 FeeCode 每条短消息费率 单位为 分 对于 MO 消息或点对点短消息 该字段无效 对于 MT 消息 该字段具体使用方法参见 6 2 13 节 6 2 15 FixedFee 短消息的包月费 封顶费 单位为 分 对于 MO 消息或点对点短消息 该字段无效 对于 MT 消息 该字段具体使用方法参见 6 2 13 节 6 2 16 MsgFormat 短消息内容体的编码格式 0 ASCII 编码 3 短消息写卡操作 4 二进制短消息 8 UCS2 编码 15 GB18030 编码 246 F6 U SIM 相关消息 其它保留 对于文字短消息 要求 MsgFormat 15 对于回执消息 要求 MsgFormat 0 6 2 17 ValidTime 短消息有效时间 格式遵循 SMPP3 3 以上版本协议 短消息有效时间在转发过程中保持不变 6 2 18 AtTime 短消息定时发送时间 格式遵循 SMPP3 3 以上版本协议 短消息定时发送时间在转发过程中保持不变 6 2 19 SrcTermID 短消息发送方号码 对于 MT 消息 SrcTermID 格式为 118 SP 服务代码 其它 可选 例如 SP 服务代码为 1234 时 SrcTermID 可以为 1181234 或 118123456 等 对于 MO 消息 固定网中 SrcTermID 格式为 区号 号码 区号前添零 例如 02087310323 07558780808 移动网中 SrcTermID 格式为 MSISDN 号码格式 对于固定网点对点消息 主叫号码为普通终端时 SrcTermID 格式为 区号 号码 区号前添零 主叫号码为爱因平台时 SrcTermID 格式为 10631 区号 号码 区号前添零 6 2 20 ChargeTermID 计费用户号码 ChargeTermID 为空时 如果是 MT 消息 则表示对被叫用户号码计费 如果是 MO 或点对点消 息 则表示对主叫用户号码计费 ChargeTermID 为非空时 表示对计费用户号码计费 6 2 21 DestTermIDCount 短消息接收号码总数 100 用于 SP 实现群发短消息 6 2 22 DestTermID 短消息接收号码 对于 MT 消息 DestTermID 连续存储 DestTermIDCount 个号码 每一个接收方号码为 21 位 固 定网中 DestTermID 格式为 区号 号码 区号前添零 移动网中 DestTermID 格式为 MS