中国电信短消息网关协议smgp协议v.doc
《中国电信短消息网关协议smgp协议v.doc》由会员分享,可在线阅读,更多相关《中国电信短消息网关协议smgp协议v.doc(31页珍藏版)》请在咨信网上搜索。
1、中国电信集团公司公司标准CT/T 1-2023基于固定电话网的信息终端及综合信息系统技术规范第七分册 短消息网关(SMGP)协议 V1.32023-04-30发布 2023-04-30实行中国电信集团公司 发布目 录前 言31合用范围42引用标准43缩略语44SMGP概述44.1.SMGP功能44.2.SMGP定义44.3.SMGP通信流程55SMGP数据包定义75.1.数据包结构75.2.请求标记说明75.3.包体结构86编码说明166.1.短消息格式代码表166.2.收费类型代码表166.3.短消息状态表166.4.Err错误代码表176.5.Status错误代码表177基于SMGP协议的
2、API函数18附录A 基于SMGP协议的API函数说明19(提醒的附录)19A.1基本规定19A.2 API数据结构说明(以C语言为例)20A.3 API函数说明22A 3.7查询短消息流量(SMGPQuery可选)26A.4配置SMGP API26A.5短信的自动分割功能27A.6错误代码含义28 前 言本标准介绍综合信息平台系统短消息网关和服务提供商内容提供商(SPCP)之间、短消息网关和短消息网关之间的通信协议。本协议简称SMGP(Short Message Gateway Protocol)。本标准起草单位: 中国电信集团公司、中国电信集团公司上海研发中心本标准重要起草人: 特别感谢:
3、亚信科技中国有限公司在本协议制订过程中的大力支持和帮助。1 合用范围本协议合用于短消息网关开发商和短消息服务提供商内容提供商。2 引用标准SMPP (Short Message Peer to Peer Protocol Specification) v3.4 3 3 缩略语见总册4 SMGP概述4.1. SMGP功能网关通信SMGP协议是短消息服务提供商内容提供商与短消息网关,以及短消息网关与短消息网关之间的通信协议。SMGP可以实现以下功能:(1) 服务提供商内容提供商向综合信息平台综合信息系统短消息用户发送短消息,例如邮件告知、天气预报等。(2) 综合信息平台综合信息系统短消息用户向服务
4、提供商内容提供商点播信息,例如查询股票查询信息、航班信息等。(3) 服务提供商内容提供商以某个短消息用户的身份向综合信息平台综合信息系统短消息用户发送传情信息,例如图片传情、音乐传情等。(4) 综合信息平台综合信息系统短消息用户发送的短消息通过短消息网关前转发送给异地的短消息用户。4.2. SMGP定义网关通信SMGP协议是一个基于数据包的交互式协议,底层通过TCP/IP协议传递数据。每个数据包都包含请求标记,代表数据包的用途。服务提供商内容提供商与短消息网关或者短消息网关与短消息网关之间采用cClient-/serverServer的方式交互信息,客户端向服务器端发送一个请求包,服务器端向客
5、户端返回回应包。客户端发送的所有请求包都包含一个唯一的序列号,服务器端返回的回应包也带有相应的序列号,以便客户辨认这是哪一个请求的回应。客户端和服务器端之间可以采用长连接或者短连接的方式通信。假如采用短连接,客户端必须以发送者、接受者或收发者的身份登录到服务器,通信完毕后断开连接。假如采用长连接,一旦认证通过建立连接,客户端与服务器端可以随时通信,在一定期间内两者之间没有发送合法的请求包,连接就中断。4.3. SMGP通信流程网关与ICPCP之间通信连接采用端标语8890,网关与网关通信连接采用端标语8900。4.3.1. SMGP登录模式 在SMGP协议的一个会话中客户端可以采用三种登录方式
6、与服务器端相连:发送模式(send mode)、接受模式(receive mode)和收发模式(transmit mode)。在发送模式中客户端只能发送短消息、在接受模式中客户端只能接受短消息、在收发模式中客户端即可既可以发送也可以接受短消息。三种模式均可以采用长连接与短连接两种连接方式的一种,根据实际情况选择。4.3.2. SPCP发送短消息SPCP以发送者或者是收发者身份登录后,就可以发送短消息。SPCP可以不等待上一个短消息发送回应包,就发送下一个短消息。 CP SMGWlogin(send /transmit mode)login_respsubmit(1)submit(2)submi
7、t_resp (1)submit_resp (2)exitexit_resp4.3.3. SPCP接受短消息SPCP以接受者或者是收发者身份登录后,短消息网关就向SPCP下发MO发送短消息,短消息网关可以不等待上一个下发MO短消息回应包,就下发发送下一个MO短消息。 SPCP SMGWlogin(receive /transmit mode)login_respdeliver(1)deliver(2)deliver_resp (1)deliver_resp (2)exitexit_resp4.3.4. SMGW转发短消息短消息网关需要把异地MT/MO短消息转发到相应的短消息网关,在转发短消息之
8、前短消息网关需要通过对方网关认证。 SPCP SMGWlongin(send /receive/ transmit mode)_longin_respforward(1)forward(2)forward_resp (1)forward_resp (2)exitexit_resp5 SMGP数据包定义SMGP基本数据类型定义如下表所示:Integer无符号整数Octet String定长字符串。位数局限性时,假如左补0则补ASCII表达的0,假如右补0则补二进制表达的05.1. 数据包结构SMGP数据包分为包头和包体两部分,包头的结构如下:字段长度(字节)数据类型说明PacketLength4
9、Integer数据包长度(包头和包体的长度之和。单位:字节)RequestID4Integer请求标记SequenceID4Integer序列号(由客户端分派,循环递增)5.2. 请求标记说明请求标记(RequestID)标记数据包的类型,请求包的请求标记和回应包的请求标记一一相应。请求名称请求标记说明login0x00000001SPCP或SMGW登录请求login_resp0x80000001SPCP或SMGW登录回应submit0x00000002SPCP发送短消息请求submit_resp0x80000002SPCP发送短消息回应deliver0x00000003SMGW向SPCP发送
10、短消息请求deliver_resp0x80000003SMGW向SPCP发送短消息回应active_test0x00000004测试通信链路是否正常请求(由客户端发起,SPCP和SMGW可以通过定期发送此请求来维持连接)active_test_resp0x80000004测试通信链路是否正常回应forward0x00000005SMGW转发MT/MO短消息请求forward_reCP0x80000005SMGW转发MT/MO短消息回应exit0x00000006退出请求exit_resp0x80000006退出回应query0x00000007CP发送短信状态记录查询请求query_resp0
11、x80000007CP短信状态记录查询结果回应mt_route_update0x00000008MT路由更新请求mt_route_update_resp0x80000008MT路由更新回应mo_route_update0x00000009MO路由更新请求mo_route_update_resp0x80000009MO路由更新回应5.3. 包体结构5.3.1. login字段长度数据类型说明UserClientID118Octet StringstringSPCP编号或者SMGW编号编号规则参见总册第六6节PasswordAuthenticatorClient1016Octet String客户
12、端密码用于鉴别客户端的接入请求 。其值通过单向MD5 hash计算得出,表达如下:AuthenticatorClient =MD5(ClientID+7 字节的0 +shared secret+timestamp)Shared secret 由中国电信服务器端与ICP客户端事先商定,timestamp格式为:MMDDHHMMSS,即月日时分秒,10位。LoginMode1Integerinteger登录类型(0=发送短消息, 1=接受短消息,2=转发收发短消息,其他保存)TimeStamp4Integer时间戳的明文,由客户端产生,格式为MMDDHHMMSS,即月日时分秒,10位数字的整型,右
13、对齐 Version1integer客户端支持的版本号(高位4bit表达主版本号,低位4bit表达次版本号)5.3.2. login_resp字段长度(字节)数据类型说明ResultStatus4Integerintegerlogin请求返回结果(参照参见错误代码表)AuthenticatorServer16Octet String服务器端认证码,当客户端认证犯错时,此项为空其值通过单向MD5 hash计算得出,表达如下:AuthenticatorServer =MD5(Status+AuthenticatorClient +shared secret)Shared secret 由中国电信服
14、务器端与ICP客户端事先商定,AuthenticatorICPClient为ICP客户端发送给SMGW服务器端的上一条消息login中的值。+Version1Integer服务器支持的最高版本号5.3.3. submit字段长度(字节)数据类型说明SubType1integer短消息子类型(0取消订阅,1订阅请求,2点播,3订阅,其他保存)NeedReport1integer是否规定返回状态报告(0=不规定,1=规定)Pk_id10Integer多包短消息标记Pk_total1Integer相同Pk_id的消息总条数,从1开始Pk_number1Integer相同Pk_id的消息序号,从1开始
15、Priority1Integerinteger发送优先级(从0到9)ServiceID10Octet Stringstring服务类型业务类型FeeType2Octet Stringstring收费类型(参照参见收费类型代码表)FeeCode6Octet Stringstring资费代码(单位为分)MsgFormat1Octet Stringinteger短消息格式(参照参见短消息格式代码表)ValidTime17Octet Stringstring有效时间,格式遵循SMPP3.3协议AtTime17Octet Stringstring定期发送时间,格式遵循SMPP3.3协议SrcTermID
16、21Octet String短消息发送用户号码作为短消息回执的目的地址ChargeTermID21Octet Stringstring计费用户号码点播、订阅、传情等业务的使用用户号码DestTermIDCount1Integerinteger短消息接受号码总数(小等于100)DestTermID21* DestTerm CountOctet Stringstring短消息接受号码(连续存储DestTermIDCount个号码)MsgLength1Integerinteger短消息长度MsgContent小等于252Octet Stringstring短消息内容Reserve8Octet Str
17、ing保存5.3.4. submit_resp字段长度(字节)数据类型说明MsgID10Octet String网关产生的短消息流水号,由三部分组成:网关代码:3字节(BCD码)时间:4字节(BCD码)序列号:3字节(BCD码)ResultStatus4IntegerintegerSubmit请求返回结果(参照参见错误代码表)5.3.5. deliver字段长度(字节)数据类型说明MsgID1Integer网关产生的短消息流水号,由三部分组成:网关代码:3字节(BCD码)时间:4字节(BCD码)序列号:3字节(BCD码)IsReport1Integerinteger是否状态报告(0=不是,1=
18、是)MsgFormat1Integerinteger短消息格式(参照参见短消息格式代码表)RecvTime14Octet Stringstring短消息接受时间(格式:yyyymmddhhmiss,例如00)SrcTermID21Octet Stringstring短消息发送号码DestTermID21Octet Stringstring短消息接受号码MsgLength1Integerinteger短消息长度MsgContent小等于252Octet Stringstring短消息内容Reserve8Octet String保存5.3.6. deliver_resp字段长度(长度)数据类型说明
19、MsgID1Integer网关产生的短消息流水号,由三部分组成:网关代码:3字节(BCD码)时间:4字节(BCD码)序列号:3字节(BCD码)ResultStatus4integerDeliver请求返回结果(参照参见错误代码表)5.3.7. active_test没有包体5.3.8. acitve_test_resp没有包体5.3.9. forward字段长度(长度)数据类型说明MsgID10Octet String网关产生的短消息流水号,由三部分组成:网关代码:3字节(BCD码)时间:4字节(BCD码)序列号:3字节(BCD码)DestSMGWNo6Octet Stringstring目的
20、网关代码SrcSMGWNo6Octet Stringstring源网关代码SMCNo6Octet String短消息中心代码SMType1Integerinteger短消息类型(0=MT,1=MO,2异地点到点短消息,3异网点到点短消息,其他保存)SubType1integer短消息子类型(0取消订阅,1订阅请求,2点播,3订阅,其他保存)ReportFlag1Integerinteger当SMType=0时,表达是否规定返回状态报告(0=不规定,1=规定)当SMType=1时,表达是否状态报告(0=不是,1=是)Pk_total1Integer多包消息总条数,从1开始Pk_number1In
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国电信 短消息 网关 协议 smgp
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【a199****6536】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【a199****6536】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。