中国电信集团公司企业标准(SMGP协议)(v30) (20050412).doc

中国电信集团公司企业标准中国电信集团公司企业标准 CT T 4 2005 基于固定电话网的信息终端及综合信息系统技术规范基于固定电话网的信息终端及综合信息系统技术规范 第七分册第七分册 短消息网关 短消息网关 SMGPSMGP 协议 协议 V3 0V3 0 2005 04 10 发布 2005 04 30 实施 中国电信集团公司 4 月 发布 第 II 页 目目 录录 前前 言言 III 1适用范围适用范围 1 2引用标准引用标准 1 3缩略语缩略语 1 4SMGP 协议概述协议概述 2 4 1定义 2 4 2通信方式 2 4 3协议应用及涉及的端口号 6 5SMGP 基本协议基本协议 8 5 1数据类型 8 5 2消息结构 9 6SMGP 扩展协议扩展协议 23 7参数定义参数定义 23 7 1消息头参数描述 23 7 2消息体必选参数描述 25 7 3消息体可选参数描述 41 8基于基于 SMGP 协议的协议的 API 函数函数 48 附录附录 A 基于基于 SMGP 协议的协议的 API 函数说明函数说明 提示的附录提示的附录 49 A 1 基本要求 49 A 2 API 数据结构说明 以 C 语言为例 50 A 3 API 函数说明 52 A 4 配置 SMGP API 57 A 5 短消息的自动分割功能 58 A 6 错误代码含义 58 附录附录 B 短消息群发功能的实现短消息群发功能的实现 61 修订历史 修订历史 62 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第页III 前前 言言 本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议 本标准是在SMGP 协议 V2 0 的基础上 根据 SP 管理平台及 3G 网络短消息 业务发展需求进行修订而成 本标准共包含 3 部分 1 SMGP 基本协议 2 SMGP 协议扩展计费接口 3 SMGP 协议扩展电子商务接口 本文只描述了第 1 部分 SMGP 基本协议 第 2 部分和第 3 部分同 SMGP 协议 V2 0 本标准起草单位 中国电信集团公司 中国电信股份有限公司上海研究院 本标准主要起草人 葛敏 顾丽丽 曹嘉骏 蒋力 施唯佳 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 1 页 1适用范围适用范围 本协议适用于短消息网络上 固定网 移动网 短消息网关与其它网元之 间进行短消息的传输 本协议适用于短消息网关 相关网元设备开发商及内容提供商 2引用标准引用标准 下列标准包括的条文 通过在本标准中引用而构成本标准的条文 本标准 出版时 所示版本均为有效 所有标准都会被修订 使用本标准的各方应探讨 使用下列标准最新版本的可能性 Short Message Peer to Peer Protocol Specification 短消息网关 SMGP 协议 V2 0 3缩略语缩略语 ESME外部短消息实体 GNS网关名称服务器 汇接网关 SP内容 服务提供商 SMC短消息中心 又称 SMSC SMGP短消息网关协议 SMGW短消息网关 又称 SMS SAG SMPP短消息点对点协议 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 2 页 4SMGP 协议概述协议概述 4 1 定义定义 SMGP 协议是 SMGW 与其它网元设备 除 SMC 外 进行短消息传输的接 口协议 非 SMC 网元设备向 SMGW 发送或从 SMGW 接收短消息 这些非 SMC 网元设备称为 ESME SMGP 协议共包括三部分 SMGP 基本协议 SMGP 协议扩展计费接口 SMGP 协议扩展电子商务接口 SMGP 基本协议是用于 SMGW 之间 及 SMGW 与 SP 之间短消息传输的 接口协议 SMGP 协议扩展计费接口是基于 SMGP 基本协议 针对短信业务计费的特 点进行扩展后的接口协议 SMGP 协议扩展电子商务接口是基于 SMGP 基本协议 应用于业务网关模 块与专业内容提供商 电子商务业务的服务提供商 如银行 证券公司 之间的 接口协议 4 2 通信方式通信方式 SMGW 与 ESME 之间共有两种连接方式 长连接和短连接 所谓长连接 指在一个 TCP 连接上可以连续发送多个数据包 在 TCP 连接保持期间 如果 没有数据包发送 需要双方发链路检测包以维持此连接 短连接是指通信双方 有数据交互时 就建立一个 TCP 连接 数据发送完成后 则断开此 TCP 连接 即每次 TCP 连接只完成一对 SMGP 消息的发送 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 3 页 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 条 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 4 页 长连接的操作流程举例如图 1 所示 建立 TCP 连接 滑动窗口不大于 W W SMGP 消息 1 客户端服务器端 SMGP 消息 2 对 SMGP 消息 1 的响应 对 SMGP 消息 2 的响应 链路检测包 链路检测包响应 建立 TCP 连接 链路检测包 链路检测包响应 拆除 TCP 连接 建立 TCP 连接 图 1 长连接操作流程 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 5 页 4 2 2 短连接短连接 通信双方以客户 服务器方式建立 TCP 连接 应答与请求在同一个连接中 完成 系统采用客户 服务器模式 操作以客户端驱动方式发起连接请求 完成 一次操作后关闭此连接 通信双方之间的消息发送后等待 T 秒后未收到响应 应立即重发 再连续 发送 N 1 次后仍未得到响应则停发 现阶段建议取值为 T 60 秒 N 3 短连接的操作流程举例如图 2 所示 对 SMGP 消息 1 的响应 SMGP 消息 1 建立 TCP 连接 拆除 TCP 连接 SMGP 消息 2 对 SMGP 消息 2 的响应 建立 TCP 连接 拆除 TCP 连接 建立 TCP 连接 客户端服务器端 图 2 短连接操作流程 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 6 页 4 3 协议应用及涉及的端口号协议应用及涉及的端口号 SMGP 协议在中国电信中的应用主要体现在两类短消息业务上 一类是固 定网短消息业务 另一类是移动网短消息业务 4 3 1 固定网短消息业务固定网短消息业务 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 固定网短消息业务系统结构简图 固定网短消息业务系统结构简图如图 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 作为 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 7 页 服务器端 一级 SMGW 作为客户端 3 一级 SMGW 与 SP 一级 SMGW 与 SP 之间采用 SMGP 协议进行短消息的传输 端口号为 8890 一级 SMGW 为服务器端 SP 为客户端 4 二级 SMGW 和 PHS 预付费平台 二级 SMGW 与 PHS 预付费平台之间采用 SMGP 协议扩展计费接口 参见 SMGP V2 0 进行计费信息的传输 端口号为 9100 预付费平台作为服务器端 二级 SMGW 作为客户端 4 3 2 基于固定网短消息的电子商务业务基于固定网短消息的电子商务业务 协议涉及的端口号具体参见短消息网关 SMGP 协议 V2 0 的 4 3 2 章节 4 3 3 移动网短消息业务移动网短消息业务 移动网短消息业务系统结构简图如图 4 所示 SMGP 协议在移动网短消息 系统中应用情况如下 1 SMGW 与 SP SMGW 与 SP 之间采用 SMGP 协议进行短消息的传输 端口号为 GNS SMGWSMGW SMCSMC 图 4 移动网短消息业务系统结构简图构图 SMGP SMGP SPSP SMGPSMGPSMGP 移动网移动网 移动网终端移动网终端 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 8 页 8890 SMGW 为服务器端 SP 为客户端 2 SMGW 与 SMGW SMGW 与 SMGW 之间采用 SMGP 协议进行短消息的传输 端口号为 8900 SMGW 与 SMGW 互为客户 服务器端 3 SMGW 与 GNS SMGW 与 GNS 之间采用 SMGP 协议进行消息传输 端口号为 8901 SMGW 为服务器端 GNS 为客户端 5SMGP 基本协议基本协议 5 1 数据类型数据类型 5 1 1 基本数据类型基本数据类型 Integer无符号整数 Octet String不强制以 0 x00 结尾的定长字符串 当位数不足时 在不明确注明的情况下 应左对齐 右补 0 x00 在 明确注明的情况下 以该字段的明确注明为准 5 1 2 可选参数可选参数 可选参数采用 TLV Tag Length Value 形式定义 每个可选参数的 Tag Length Value 的定义见 7 3 节 字段字段 长度 字节 长度 字节 数据类型数据类型说明说明 Tag2Integer字段的标签 用于唯一标识 可选参数 Length2Integer字段的长度 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 9 页 Value可变长度可变类型字段内容 5 2 消息结构消息结构 项目项目说明说明 Message Header消息头 所有消息公共包头 Message Body消息体 5 2 1 消息头结构消息头结构 字段字段 长度 字节 长度 字节 数据类型数据类型说明说明参考参考 PacketLength4Integer数据包长度7 1 1 RequestID4Integer请求标识7 1 2 SequenceID4Integer消息流水号7 1 3 5 2 2 消息体结构消息体结构 5 2 2 1登录操作 登录操作 Login Login 操作的目的是客户端向服务器端注册作为一个合法客户端身份 若 注册成功后即建立了应用层的连接 此后客户端可以与此服务器端进行消息的 接收和发送 服务器端以 Login Resp 消息响应客户端的请求 5 2 2 1 1Login 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 ClientID8Octet String 客户端用来登录服务器端 的用户账号 7 2 1 必必 选选 参参 数数 AuthenticatorC lient 16Octet String 客户端认证码 用来鉴别 客户端的合法性 7 2 2 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 10 页 LoginMode1Integer客户端用来登录服务器端 的登录类型 7 2 3 TimeStamp4Integer时间戳7 2 4 ClientVersion1Integer客户端支持的协议版本号7 2 5 5 2 2 1 2Login Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 Status4Integer请求返回结果7 2 6 AuthenticatorS erver 16Octet String 服务器端返回给客户端的 认证码 7 2 7 必必 选选 参参 数数 ServerVersion1Integer服务器端支持的最高版本 号 7 2 8 5 2 2 2SP 向向 SMGW 提交短消息的操作 提交短消息的操作 Submit 5 2 2 2 1Submit 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 MsgType1Integer短消息类型7 2 9 NeedReport1IntegerSP 是否要求返回状态报 告 7 2 10 Priority1Integer短消息发送优先级7 2 11 ServiceID10Octet String 业务代码7 2 12 FeeType2Octet String 收费类型7 2 13 FeeCode6Octet String 资费代码7 2 14 FixedFee6Octet String 包月费 封顶费7 2 15 MsgFormat1Integer短消息格式7 2 16 必必 选选 参参 数数 ValidTime17Octet String 短消息有效时间7 2 17 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 11 页 AtTime17Octet String 短消息定时发送时间7 2 18 SrcTermID21Octet String 短信息发送方号码7 2 19 ChargeTermID21Octet String 计费用户号码7 2 20 DestTermIDCo unt 1Integer短消息接收号码总数7 2 21 DestTermID21 Dest TermCo unt Octet String 短消息接收号码7 2 22 MsgLength1Integer短消息长度7 2 23 MsgContentMsgLen gth Octet String 短消息内容7 2 24 Reserve8Octet String 保留7 2 25 字段字段数据类型数据类型说明说明参考参考 TP pidTLVGSM 协议类型7 3 2 TP udhiTLVGSM 协议类型7 3 3 LinkIDTLV交易标识7 3 4 MsgSrcTLV信息内容的来源 ChargeUserTypeTLV计费用户类型7 3 5 ChargeTermTypeTLV计费用户的号码类型7 3 6 ChargeTermPseudoTLV计费用户的伪码7 3 7 DestTermTypeTLV短消息接收方号码的类型7 3 8 DestTermPseudoTLV短消息接收方的伪码7 3 9 PkTotalTLV相同 MsgID 的消息总条数7 3 10 PkNumberTLV相同 MsgID 的消息序号7 3 11 SubmitMsgTypeTLVSP 发送的消息类型7 3 12 SPDealResultTLVSP 对消息的处理结果7 3 13 可可 选选 参参 数数 MServiceIDTLV业务代码 用于移动网业 务 7 3 19 短信平台支持短信的群发功能 关于短信群发功能的实现请参阅 附录 B 短消息群发功能的实现 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 12 页 5 2 2 2 2Submit Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 MsgID10Octet String 短消息流水号7 2 26必必 选选 参参 数数 Status4Integer请求返回结果7 2 6 5 2 2 3SMGW 向向 SP 下发短消息的操作 下发短消息的操作 Deliver 5 2 2 3 1Deliver 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 MsgID10Octet String 短消息流水号7 2 26 IsReport1Integer是否为状态报告7 2 27 MsgFormat1Integer短消息格式7 2 28 RecvTime14Octet String 短消息接收时间7 2 28 SrcTermID21Octet String 短消息发送号码7 2 19 DestTermID21Octet String 短消息接收号码7 2 22 MsgLength1Integer短消息长度7 2 23 MsgContentMsgLen gth Octet String 短消息内容7 2 24 必必 选选 参参 数数 Reserve8Octet String 保留7 2 25 字段字段数据类型数据类型说明说明参考参考 TP pidTLVGSM 协议类型7 3 2 TP udhiTLVGSM 协议类型7 3 3 LinkIDTLV交易标识7 3 4 SrcTermTypeTLV短消息发送方的号码类型7 3 14 SrcTermPseudoTLV短消息发送方的伪码7 3 15 SubmitMsgTypeTLVSP 发送的消息类型7 3 12 可可 选选 参参 数数 SPDealResultTLVSP 对消息的处理结果7 3 13 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 13 页 5 2 2 3 2Deliver Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 MsgID10Octet String 短消息流水号7 2 26必必 选选 参参 数数 Status4Integer请求返回结果7 2 6 5 2 2 4源源 SMGW 向目的向目的 SMGW 转发短消息的操作 转发短消息的操作 Forward 5 2 2 4 1Forward 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 MsgID10Octet String 短消息流水号7 2 26 DestSMGWNo6Octet String 目的 SMGW 代码7 2 29 SrcSMGWNo6Octet String 源 SMGW 代码7 2 30 SMCNo6Octet String 短消息中心代码7 2 31 MsgType1Integer短消息类型7 2 9 ReportFlag1Integer状态报告标志7 2 32 Priority1Integer短消息发送优先级7 2 11 ServiceID10Octet String 业务代码7 2 12 FeeType2Octet String 资费类型7 2 13 FeeCode6Octet String 资费代码7 2 14 FixedFee6Octet String 包月费 封顶费7 2 15 MsgFormat1Integer短消息格式7 2 16 必必 选选 参参 数数 ValidTime17Octet String 有效时间7 2 17 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 14 页 AtTime17Octet String 定时发送时间7 2 18 SrcTermID21Octet String 短消息发送用户号码7 2 19 DestTermID21Octet String 短消息接收用户号码7 2 22 ChargeTermID21Octet String 计费用户号码7 2 20 MsgLength1Integer短消息长度7 2 23 MsgContentMsgLen gth Octet String 短消息内容7 2 24 Reserve8Octet String 保留7 2 25 字段字段数据类型数据类型说明说明参考参考 TP pidTLVGSM 协议类型7 3 2 TP udhiTLVGSM 协议类型7 3 3 LinkIDTLV交易标识7 3 4 ChargeUserTypeTLV计费用户类型7 3 5 NodesCountTLV经过的网关数量7 3 16 MsgSrcTLV信息内容的来源7 3 17 ChargeTermPseudoTLV计费用户的伪码7 3 7 SrcTermPseudoTLV短消息发送方的伪码7 3 14 DestTermPseudoTLV短消息接收方的伪码7 3 15 SrcTypeTLV传递给 SP 的源号码的类 型 7 3 18 PkTotalTLV相同 MsgID 的消息总条数7 3 10 PkNumberTLV相同 MsgID 的消息序号7 3 11 SubmitMsgTypeTLVSP 发送的消息类型7 3 12 SPDealResultTLVSP 对消息的处理结果7 3 13 可可 选选 参参 数数 MServiceIDTLV业务代码 用于移动网业 务 7 3 19 5 2 2 4 2Forward Resp 字段字段长度长度数据类型数据类型说明说明参考参考 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 15 页 字节 字节 MsgID10Octet String SMGW 产生的短消息流水 号 7 2 26必必 选选 参参 数数 Status4Integer请求返回结果7 2 6 字段字段数据类型数据类型说明说明参考参考 PkTotalTLV相同 MsgID 的消息总条数7 3 10 可可 选选 参参 数数PkNumberTLV相同 MsgID 的消息序号7 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 7SP 向向 SMGW 查询短消息发送状态的操作 查询短消息发送状态的操作 Query 可选 可选 5 2 2 7 1Query 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 16 页 QueryTime8Octet String 查询时间7 2 33 QueryType1Integer查询类别7 2 34 必必 选选 参参 数数QueryCode10Octet String 查询码7 2 35 5 2 2 7 2Query Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 QueryTime8Octet String 查询时间7 2 33 QueryType1Integer查询类别7 2 34 QueryCode10Octet String 查询码 业务类型 7 2 35 MT TLMsg4Integer接收短消息总数7 2 36 MT Tlusr4Integer接收用户总数7 2 37 MT Scs4Integer成功转发数量7 2 38 MT WT4Integer待转发数量7 2 39 MT FL4Integer转发失败数量7 2 40 MO Scs4Integer成功送达数量7 2 41 MO WT4Integer待送达数量7 2 42 MO FL4Integer送达失败数量7 2 43 必必 选选 参参 数数 Reverse8Octet String 保留7 2 25 5 2 2 8SMGW 向向 GNS 查询终端路由的操作 查询终端路由的操作 Query TE Route 5 2 2 8 1Query TE Route 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 必必 选选 参参 SrcGatewayID6Octet String 源网关代码7 2 44 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 17 页 数数 QueryTermID21Octet String 查询号码7 2 45 5 2 2 8 2Query TE Route Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 Status4Integer请求返回结果7 2 6 RouteID4Integer路由编号7 2 46 DestGatewayI D 6Octet String 目标网关代码7 2 47 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 TermRangeID10Octet String 路由号码段7 2 50 ProvinceCode4Octet String 终端所属省代号7 2 51 UserType1Integer用户类型 该字段保留 7 2 52 必必 选选 参参 数数 Time14Octet String 时间戳7 2 53 5 2 2 9SMGW 向向 GNS 查询查询 SP 路由的操作 路由的操作 Query SP Route 5 2 2 9 1Query SP Route 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 SrcGatewayID6Octet String 源网关代码7 2 44必必 选选 参参 数数 QueryTermID21Octet String 查询号码7 2 45 5 2 2 9 2Query SP Route Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 18 页 Status4Integer请求返回结果7 2 6 RouteID4Integer路由编号7 2 46 DestGatewayI D 6Octet String 目标网关代码7 2 47 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 SPID8Octet String SP 的企业代码7 2 54 SPCode21Octet String SP 的服务代码7 2 55 SPAccessType1IntegerSP 接入类型7 2 56 SPType1IntegerSP 类型7 2 57 必必 选选 参参 数数 Time14Octet String 时间戳7 2 53 5 2 2 10SMGW 向向 GNS 获取所有终端路由的操作 获取所有终端路由的操作 Get All TE Route 5 2 2 10 1 Get All TE Route 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 SrcGatewayID6Octet String 源网关代码7 2 44 RouteType4Octet String 路由类型7 2 58 必必 选选 参参 数数 LastRouteID4Integer已经接收的上一条路由编 号 7 2 59 5 2 2 10 2 Get All TE Route Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 Status4Integer请求返回结果7 2 6必必 RouteID4Integer路由编号7 2 46 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 19 页 DestGatewayI D 6Octet String 目标网关代码7 2 47 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 TermRangeID10Octet String 路由号码段7 2 50 ProvinceCode4Octet String 终端所属省代号7 2 51 UserType1Integer用户类型 该字段保留 7 2 52 RouteTotal4Integer返回路由总数7 2 60 RouteNumber4Integer当前返回的路由序号7 2 61 选选 参参 数数 Time14Octet String 时间戳7 2 53 5 2 2 11SMGW 向向 GNS 获取所有获取所有 SP 路由的操作 路由的操作 Get All SP Route 5 2 2 11 1 Get All SP Route 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 SrcGatewayID6Octet String 源网关代码7 2 44 RouteType4Octet String 路由类型7 2 58 必必 选选 参参 数数 LastRouteID4Integer已经接收的上一条路由编 号 7 2 59 5 2 2 11 2 Get All SP Route Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 Status4Integer请求返回结果7 2 6 RouteID4Integer路由编号7 2 46 必必 选选 DestGatewayI D 6Octet String 目标网关代码7 2 47 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 20 页 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 SPID8Octet String SP 的企业代码7 2 54 SPCode21Octet String SP 的服务代码7 2 55 SPAccessType1IntegerSP 接入类型7 2 56 SPType1IntegerSP 类型7 2 57 RouteTotal4Integer返回路由总数7 2 60 RouteNumber4Integer当前返回的路由序号7 2 61 参参 数数 Time14Octet String 时间戳7 2 53 5 2 2 12SMGW 向向 GNS 更新终端路由的操作 更新终端路由的操作 Update TE Route 5 2 2 12 1 Update TE Route 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 UpdateType1Integer更新类型7 2 62 RouteID4Integer路由编号7 2 46 DestGatewayI D 6Octet String 目标网关代码7 2 47 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 TermRangeID10Octet String 路由号码段7 2 50 ProvinceCode4Octet String 终端所属省代号7 2 51 必必 选选 参参 数数 UserType1Integer用户类型 该字段保留 7 2 52 5 2 2 12 2 Update TE Route Resp 字段字段长度长度数据类型数据类型说明说明参考参考 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 21 页 字节 字节 Status4Integer请求返回结果7 2 6 RouteID4Integer路由编号7 2 46 必必 选选 参参 数数 Time14Octet String 时间戳7 2 53 5 2 2 13SMGW 向向 GNS 更新更新 SP 路由的操作 路由的操作 Update SP Route 5 2 2 13 1 Update SP Route 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 UpdateType1Integer更新类型7 2 62 RouteID4Integer路由编号7 2 46 DestGatewayI D 6Octet String 目标网关代码7 2 47 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 SPID8Octet String SP 的企业代码7 2 54 SPCode21Octet String SP 的服务代码7 2 55 SPAccessType1IntegerSP 接入类型7 2 56 必必 选选 参参 数数 SPType1IntegerSP 类型7 2 57 5 2 2 13 2 Update SP Route Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 Status4Integer请求返回结果7 2 6必必 选选 参参 数数 RouteID4Integer路由编号7 2 46 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 22 页 Time14Octet String 时间戳7 2 53 5 2 2 14GNS 向向 SMGW 更新终端路由的操作 更新终端路由的操作 Push Update TE Route 5 2 2 14 1 Push Update TE Route 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 UpdateType1Integer更新类型7 2 62 RouteID4Integer路由编号7 2 46 DestGatewayI D 6Octet String 目标网关代码7 2 47 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 TermRangeID10Octet String 路由号码段7 2 50 ProvinceCode4Octet String 终端所属省代号7 2 51 UserType1Integer用户类型 该字段保留 7 2 52 必必 选选 参参 数数 Time14Octet String 时间戳7 2 53 5 2 2 14 2 Push Update TE Route Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 必必 选选 参参 数数 Status4Integer请求返回结果7 2 6 5 2 2 15GNS 向向 SMGW 更新更新 SP 路由的操作 路由的操作 Push Update SP Route 5 2 2 15 1 Push Update SP Route 字段字段长度长度数据类型数据类型说明说明参考参考 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 23 页 字节 字节 UpdateType1Integer更新类型7 2 62 RouteID4Integer路由编号7 2 46 DestGatewayI D 6Octet String 目标网关代码7 2 47 DestGatewayIP15Octet String 目标网关 IP 地址7 2 48 DestGatewayP ort 2Integer目标网关 IP 端口7 2 49 SPID8Octet String SP 的企业代码7 2 54 SPCode21Octet String SP 的服务代码7 2 55 SPAccessType1IntegerSP 接入类型7 2 56 SPType1IntegerSP 类型7 2 57 必必 选选 参参 数数 Time14Octet String 时间戳7 2 53 5 2 2 15 2 Push Update SP Route Resp 字段字段 长度长度 字节 字节 数据类型数据类型说明说明参考参考 必必 选选 参参 数数 Status4Integer请求返回结果7 2 6 6SMGP 扩展协议扩展协议 SMGP 扩展协议具体参见短消息网关 SMGP 协议 V2 0 的第 6 章节 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 24 页 7参数参数定义定义 7 1 消息头参数描述消息头参数描述 7 1 1 PacketLength SMGP 数据包长度 指包头和包体的长度之和 单位是 字节 7 1 2 RequestId 请求标识表示 SMGP 数据包的类型 请求包的请求标识和应答包的请求标 识一一对应 SMGP 协议的请求标识定义如下 请求名称请求名称请求标识请求标识说明说明 Login0 x00000001客户端登录 Login Resp0 x80000001客户端登录应答 Submit0 x00000002提交短消息 Submit Resp0 x80000002提交短消息应答 Deliver0 x00000003下发短消息 Deliver Resp0 x80000003下发短消息应答 Active Test0 x00000004链路检测 Active Test Resp0 x80000004链路检测应答 Forward0 x00000005短消息前转 Forward Resp0 x80000005短消息前转应答 Exit0 x00000006退出请求 Exit Resp0 x80000006退出应答 Query0 x00000007SP 统计查询 Query Resp0 x80000007SP 统计查询应答 Query TE Route0 x00000008查询 TE 路由 Query TE Route Resp 0 x80000008查询 TE 路由应答 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 25 页 Query SP Route0 x00000009查询 SP 路由 Query SP Route Resp 0 x80000009查询 SP 路由应答 Payment Request0 x0000000A扣款请求 用于预付费系统 参见增值业务计 费方案 Payment Request Resp 0 x8000000A扣款请求响应 用于预付费系统 参见增值业 务计费方案 下同 Payment Affirm0 x0000000B扣款确认 用于预付费系统 参见增值业务计 费方案 Payment Affirm Resp 0 x8000000B扣款确认响应 用于预付费系统 参见增值业 务计费方案 Query UserState0 x0000000C查询用户状态 用于预付费系统 参见增值业 务计费方案 Query UserState Resp 0 x8000000C查询用户状态响应 用于预付费系统 参见增 值业务计费方案 Get All TE Rout e 0 x0000000D获取所有终端路由 Get All TE Rout e Resp 0 x8000000D获取所有终端路由应答 Get All SP Route0 x0000000E获取所有 SP 路由 Get All SP Route Resp 0 x8000000E获取所有 SP 路由应答 Update TE Route0 x0000000FSMGW 向 GNS 更新终端路由 Update TE Route Resp 0 x8000000FSMGW 向 GNS 更新终端路由应答 Update SP Route0 x00000010SMGW 向 GNS 更新 SP 路由 Update SP Route Resp 0 x80000010SMGW 向 GNS 更新 SP 路由应答 Push Update TE Route 0 x00000011GNS 向 SMGW 更新终端路由 Push Update TE Route Resp 0 x80000011GNS 向 SMGW 更新终端路由应答 Push Update SP Route 0 x00000012GNS 向 SMGW 更新 SP 路由 Push Update SP Route Resp 0 x80000012GNS 向 SMGW 更新 SP 路由应答 其它保留 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 26 页 7 1 3 SequenceId SMGP 消息流水号 用来匹配请求数据包和应答数据包 应答数据包的流水号字段必须与请求包的流水号字段一致 流水号字段由请求包发起方分配 取值范围为 0 x00000000 0 xFFFFFFFF 顺序累加 步长为 1 循环使用 7 2 消息体必选参数描述消息体必选参数描述 7 2 1 ClientID 客户端用来登录服务器端的用户账号 当客户端为 SP 时 用户帐号为 SP 服务代码 当客户端为 SMGW 时 用 户帐号为 SMGW 代码 当客户端为 GNS 时 用户帐号为 GNS 代码 7 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 7 2 3 LoginMode 客户端用来登录服务器端的登录模式 基于固定电话网的信息终端及综合信息系统技术规范 第七分册 第 27 页 0 发送短消息 send mode 1 接收短消息 receive mode 2 收发短消息 transmit mode 其它保留 7 2 4 TimeStamp 时间戳 例如 3 月 1 日 0 时 0 分