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

2001 6 22 中国电信短信网关通信协议 1 0 第 页1 中国电信集团公司企业标准中国电信集团公司企业标准 CT T 1 2001 标准型信息终端综合平台技术规范标准型信息终端综合平台技术规范 第七分册 短信网关协议第七分册 短信网关协议 Short Message Gateway Protocol v1 0 2001 06 18 发布 2001 06 18 实施 中国电信集团公司 发布 2001 6 22 中国电信短信网关通信协议 1 0 第 页2 目 录 1 介绍介绍 3 1 1 目标 3 1 2 适用范围 3 1 3 缩略语 3 1 4 参考资料 4 2 SMGP 概述概述 4 2 1 SMGP 功能 4 2 2 SMGP 定义 4 2 3 SMGP 通信流程 5 2 3 1 SP发送短信 5 2 3 2 SP接收短信 5 2 3 3 SMG转发短信 6 2 3 4 SP发送管理信息 7 3 SMGP 数据包定义数据包定义 7 3 1 数据包结构 7 3 2 请求说明 7 3 3 包体结构 8 3 3 1 login 8 3 3 2 login resp 8 3 3 3 submit 8 3 3 4 submit resp 9 3 3 5 deliver 9 3 3 6 deliver resp 9 3 3 7 active test 9 3 3 8 acitve test resp 10 3 3 9 forward 10 3 3 10 forword resp 10 3 3 11 exit 10 3 3 12 exit resp 11 3 4 特殊短信格式 11 3 4 1 状态报告格式 11 3 4 2 修改密码格式 11 3 4 3 包月收费格式 12 4 编码说明编码说明 12 4 1 短信格式代码表 12 4 2 收费类型代码表 12 4 3 错误代码表 12 2001 6 22 中国电信短信网关通信协议 1 0 第 页3 1 介绍介绍 1 1 目标目标 本文档 用文档表示是否合适 详细介绍中国电信的短信网关 SMG 应为 SMGW 为统一起见 建议所有的短信网关改为短消息网关 所有的短信中心改为短 消息中心 和服务提供商 SP 之间 短信网关和短信网关之间的通信协议 本协议简称 SMGP Short Message Gateway Protocol 服务提供商使用 SMGP 接入短信网关 向中国电信的短信用户发送短信 以 及接收短信用户发送的短信 短信网关使用 SMGP 相互转发短信 本标准起草单位 中国电信集团公司 中国电信集团上海研发中心 中 国亚信科技公司 本标准主要起草人 1 2 适用范围适用范围 本协议使用于短信网关开发商和短信服务提供商 1 3 缩略语缩略语 SMGP中国电信短信网关通信协议 SMG短信网关 SMPP短信点对点协议 SMC短信中心 MO由短信用户向短信服务提供商发送的短信 MT由短信服务提供商向用户电话发送的短信 SP服务提供商 2001 6 22 中国电信短信网关通信协议 1 0 第 页4 1 4 参考资料参考资料 Short Message Peer to Peer Protocol Specification v3 4 GSM 3 40 GSM 3 38 2 SMGP 概述概述 2 1 SMGP 功能功能 网关通信协议是短信服务提供商与短信网关 以及短信网关与短信网关之 间的通信协议 SMGP 可以实现以下功能 服务提供商向中国电信短信用户发送 push 短信 例如邮件通知 天气预报等 中国电信短信用户向服务提供商点播信息 例如查询股票信息 航 班信息 服务提供商以某个短信用户的身份向中国电信短信用户发送传情信 息 是否应与总册中的说法一致 指订阅信息 例如图片传情 音乐传情等 2 2 SMGP 定义定义 网关通信协议是一个基于数据包的交互式协议 通过 TCP IP 传递数据 每 个数据包都包含请求标识 代表数据包的用途 服务提供商与短信网关或者短 信网关与短信网关之间采用客户 服务器的方式交互信息 客户向服务器发送一 个请求包 服务器向客户返回回应包 客户发送的所有请求包都包含一个唯一的序列号 服务器返回的回应包也 带有相应的序列号 以便客户识别这是哪一个请求的回应 客户和服务器之间采用长连接 如果在一定时间内客户和服务器之间没有 发送合法的请求包 连接就中断 2001 6 22 中国电信短信网关通信协议 1 0 第 页5 2 3 SMGP 通信流程通信流程 2 3 1 SP 发送短信 SP 以发送者身份登录后 就可以发送短信 SP 可以不等待上一个短信发送 回应包 就发送下一个短信 SPSMG login send mode login resp submit 1 submit 2 submit resp 1 submit resp 2 exit exit resp 2 3 2 SP 接收短信 SP 以接收者身份登录后 短信网关就向 SP 下发 MO 短信 短信网关可以不 等待上一个下发 MO 短信回应包 就下发下一个 MO 短信 2001 6 22 中国电信短信网关通信协议 1 0 第 页6 SPSMG login receive mode login resp deliver 1 deliver 2 deliver resp 1 deliver resp 2 exit exit resp 2 3 3 SMG 转发短信 短信网关需要把异地 MT MO 短信转发到相应的短信网关 在转发之前短 信网关需要通过网关认证 SMGSMG login gateway mode login resp forward 1 forward 2 forward resp 1 forward resp 2 exit exit resp 2001 6 22 中国电信短信网关通信协议 1 0 第 页7 2 3 4 SP 发送管理信息 SP 可以通过发送特殊格式的短信向短信网关发送管理信息 例如修改密码 请求 包月收费请求等 发送的流程与发送短信一样 3 SMGP 数据包定义数据包定义 3 1 数据包结构数据包结构 SMGP 数据包分为包头和包体两部分 包头的结构如下 字段字段长度长度数据类型数据类型说明说明 PacketLength4Integer数据包长度 包头和包体的长度 之和 RequestID4Integer请求标识 SequenceID4Integer序列号 由客户分配 递增 3 2 请求说明请求说明 请求标识 RequestID 代表数据包的作用 请求包的请求标识和回应包 的请求标识一一对应 请求名称请求名称请求标识请求标识说明说明 Login0 x00000001SP 或 SMG 登录请求 login resp0 x80000001SP 或 SMG 登录回应 Submit0 x00000002SP 发送短信请求 submit resp0 x80000002SP 发送短信回应 deliver0 x00000003SMG 向 SP 下发接收短信请求 deliver resp0 x80000003SMG 向 SP 下发接收短信回应 active test0 x00000004测试通信链路是否正常请求 由客户端发起 SP 和 SMG 可以通过定时发送此请求来维持 连接 active test resp0 x80000004测试通信链路是否正常回应 2001 6 22 中国电信短信网关通信协议 1 0 第 页8 forward0 x00000005SMG 转发 MT MO 短信请求 forward resp0 x80000005SMG 转发 MT MO 短信回应 exit0 x00000006退出请求 exit resp0 x80000006退出回应 3 3 包体结构包体结构 3 3 1 login 字段字段长度长度数据类型数据类型说明说明 User10stringSP 编号或者 SMG 编号 Password10密码 LoginMode1integer登录类型 0 发送短信 1 接收短信 2 转发短信 3 3 2 login resp 字段字段长度长度数据类型数据类型说明说明 result4integer返回结果 参照错误代码表 3 3 3 submit 字段字段长度长度数据类数据类 型型 说明说明 NeedReport1integer是否要求返回状态报告 0 不要求 1 要求 Priority1integer发送优先级 从 0 到 9 ServiceID10integerst ring 服务类型 FeeType2string收费类型 参照收费类型代码表 FeeCode6string资费代码 单位为分 MsgFormat1integer短信格式 参照短信格式代码表 ValidTime17string有效时间 格式遵循 SMPP3 3 协议 AtTime17string定时发送时间 格式遵循 SMPP3 3 协议 SrcTermID21string短信发送号码 DestTermIDCount1integer短信接收号码总数 小于 100 2001 6 22 中国电信短信网关通信协议 1 0 第 页9 DestTermID21 DestTermI DCount string短信接收号码 连续存储 DestTermIDCount 个号码 MsgLength1integer短信长度 小于 160 MsgContent160string短信内容 3 3 4 submit resp 字段字段长度长度数据类型数据类型说明说明 MsgID10string短信标识 result4integer返回结果 参照错误代码表 3 3 5 deliver 字段字段长度长度数据类数据类 型型 说明说明 MsgID10string短信标识 IsReport1integer是否状态报告 0 不是 1 是 MsgFormat1integer短信格式 参照短信格式代码表 RecvTime14string短信接收时间 格式 yyyymmddhhmiss 例如 20010301200000 SrcTermID21string短信发送号码 DestTermID21string短信接收号码 MsgLength1integer短信长度 小于 160 MsgContent160string短信内容 3 3 6 deliver resp 字段字段长度长度数据类型数据类型说明说明 MsgID10string短信标识 result4integer返回结果 参照错误代码表 3 3 7 active test 没有包体 2001 6 22 中国电信短信网关通信协议 1 0 第 页10 3 3 8 acitve test resp 没有包体 3 3 9 forward 字段字段长度长度数据类数据类 型型 说明说明 DestSMGNo6string目标网关代码 SrcSMGNo6string源网关代码 SMType1integer短信类型 0 MT 1 MO NeedReport1integer当 SMType 0 时 表示是否要求返 回状态报告 0 不要求 1 要求 当 SMType 1 时 表示是否状态报 告 0 不是 1 是 Priority1integer发送优先级 从 0 到 9 ServiceID1integer服务类型 FeeType2string资费类型 参照收费类型代码表 FeeCode6string资费代码 单位为分 MsgFormat1integer短信格式 参照短信格式代码表 ValidTime17string有效时间 格式遵循 SMPP3 3 协议 AtTime17string定时发送时间 格式遵循 SMPP3 3 协议 SrcTermID21string短信发送号码 DestTermID21string短信接收号码 MsgLength1integer短信长度 小于 160 MsgContent160string短信内容 3 3 10 forword resp 字段字段长度长度数据类型数据类型说明说明 MsgID10string短信标识 Result4integer返回结果 参照错误代码表 3 3 11 exit 没有包体 2001 6 22 中国电信短信网关通信协议 1 0 第 页11 3 3 12 exit resp 没有包体 3 4 特殊短信格式特殊短信格式 状态报告和管理信息都存储在短信内容里 因此它们是特殊的短信 各自 具有特殊的格式 3 4 1 状态报告格式 字段字段长度长度数据类型数据类型说明说明 submit date12string短信提交时间 格式 yymmddhhmiss 例如 010331200000 done date12string短信下发时间 格式 yymmddhhmiss 例如 010331200000 Status7string短信状态 参照短信状态表 Err3string具体值参见 Mobile Application Part MAP specification GSM 09 02 version 7 3 0 Release 1998 MAP MT FORWARD SHORT MESSAGE 消息的错误代码定义 短信状态表 Message StateFinal Message StatesDescription DELIVEREDDELIVRDMessage is delivered to destination EXPIREDEXPIREDMessage validity period has expired DELETEDDELETEDMessage has been deleted UNDELIVERABLEUNDELIVMessage is undeliverable ACCEPTEDACCEPTDMessage is in accepted state i e has been manually read on behalf of the subscriber by customer service UNKNOWNUNKNOWNMessage is in invalid state REJECTEDREJECTDMessage is in a rejected state 3 4 2 修改密码格式