聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議

聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議 1 1 1 1 1 2 2 2 2 2 2 2 2 2通信節(jié)點(diǎn)編號(hào)規(guī)則 2序列號(hào)的定義 2通信的安全性 2 2被叫方付費(fèi) 付費(fèi) 第三方付費(fèi) 2通用HTTP方式 2 2專(zhuān)用SGIP方式 通信初始化 2 2 2 2 2 2 2通信初始化 通信過(guò)程 通信結(jié)束 故障處理 兩個(gè)SMG之間的消息 2通信初始化 通信過(guò)程......................................................2..通信結(jié)束 故障處理 2 2操作 Submit命令的請(qǐng)求內(nèi)容 2Submit命令的應(yīng)答內(nèi)容 2操作 Deliver命令的請(qǐng)求內(nèi)容 2Deliver命令的應(yīng)答內(nèi)容 2操作 Report命令的請(qǐng)求內(nèi)容 2Report命令的應(yīng)答內(nèi)容 2操作 UserRpt命令的請(qǐng)求內(nèi)容 2UserRpt命令的應(yīng)答內(nèi)容 2操作 Trace命令的請(qǐng)求內(nèi)容 2Trace命令的應(yīng)答內(nèi)容 2 2數(shù)據(jù)類(lèi)型 消息頭的格式 消息體的格式 2Unbind操作 2 2Deliver操作 2 2AddSP操作 2ModifySP操作 2DeleteSP操作 2QueryRoute操作 2AddTeleSeg操作 2ModifyTeleSeg操作 2DeleteTeleSeg操作 2AddSMG操作 2ModifySMG操作 2DeleteSMG操作 2 2命令的語(yǔ)法 應(yīng)答的語(yǔ)法 命令的語(yǔ)法 應(yīng)答的語(yǔ)法 2命令的語(yǔ)法 應(yīng)答的語(yǔ)法 2 2 2計(jì)費(fèi)類(lèi)別定義 2狀態(tài)與短消息狀態(tài)的映射 2 2 2 2GNSGatewayNameServer，負(fù)責(zé)系統(tǒng)路由的管理和同步SGIPShortMessageGatewayInt2系統(tǒng)體系結(jié)構(gòu)了確保路由表存儲(chǔ)的安全性，網(wǎng)絡(luò)中設(shè)置主備用GNS，兩個(gè)GNS要保持一致和用戶號(hào)碼來(lái)綜合判斷。如果付費(fèi)號(hào)碼為空，或付費(fèi)號(hào)碼據(jù)用戶號(hào)碼來(lái)選擇路由；否則根據(jù)付費(fèi)號(hào)碼所代表的手做是考慮到了系統(tǒng)計(jì)費(fèi)和用戶鑒權(quán)的可行性，關(guān)于計(jì)費(fèi)和用戶鑒權(quán)的細(xì)節(jié)，請(qǐng)通信流程采用專(zhuān)用SGIP方式承載時(shí)，通信雙方互為客戶端和服務(wù)器端。當(dāng)客戶端要發(fā)送命令時(shí)，主動(dòng)向服務(wù)器端建立連接，然后向服務(wù)器端發(fā)送命令，并接收應(yīng)答；服務(wù)器端從客戶端接收命令，返回應(yīng)答。連接建立以后，客戶端可以連續(xù)發(fā)送多條命令。命令發(fā)送完并接收到所有應(yīng)答后，客戶端應(yīng)該主動(dòng)斷開(kāi)連接。但是，命令及其應(yīng)答之間的時(shí)間間隔最大不能超過(guò)30秒(默認(rèn)，可配置)（如果命令應(yīng)答時(shí)間超過(guò)最大等待時(shí)間，則要求客戶端重發(fā)該條命令，重發(fā)機(jī)制參見(jiàn)業(yè)務(wù)聯(lián)網(wǎng)規(guī)范有關(guān)內(nèi)容），且待應(yīng)答的命令不得超過(guò)32條（可以根據(jù)線路的質(zhì)量和服務(wù)器的處理能力配置）。而且，如果服務(wù)器端檢測(cè)出一條連接長(zhǎng)時(shí)間空閑(默認(rèn)60秒，可配置)，可以主動(dòng)斷開(kāi)該連接。如果需要，客戶端可以同時(shí)向一個(gè)服務(wù)器端建立多個(gè)連接（SMG與單個(gè)其他SMG最多不能建立超過(guò)15個(gè)連承載方式不同的是，該種方式一次連接僅僅傳送一條命令，而且連接的認(rèn)證采其中,?AAAA表示四位長(zhǎng)途區(qū)號(hào)(不足短消息網(wǎng)關(guān)系統(tǒng)之中傳輸?shù)拿恳粭l命令都有一個(gè)序列號(hào)，序列號(hào)由命令源節(jié)點(diǎn)產(chǎn)生并唯一標(biāo)記一條命令；也就是說(shuō)，網(wǎng)關(guān)系統(tǒng)中任何兩個(gè)命令的序列號(hào)多次轉(zhuǎn)發(fā)才能到達(dá)SMSC2A，而轉(zhuǎn)發(fā)該命令的每一次通信過(guò)程中使用的命令的序號(hào)均相同，為SP1X與SMG1通信所使用的序列號(hào)。對(duì)于MO短消息，例如SMSC1B向SP3X發(fā)送一條命令，短消息首先采用SMPP協(xié)議發(fā)送到SMG1，經(jīng)過(guò)SMG1轉(zhuǎn)發(fā)時(shí)序列號(hào)必須由SMG1重新生成（此時(shí)命令源節(jié)點(diǎn)MG1）。序列號(hào)分成三部分，每部分為一2位整數(shù)，第一部分表示命令源節(jié)點(diǎn)的編號(hào)，第二部分表示命令產(chǎn)生的日期和時(shí)間(網(wǎng)關(guān)系統(tǒng)中的任何命令的保存時(shí)間分25秒產(chǎn)生的命令，其第二部分為十進(jìn)制25；第三部分由0開(kāi)始，循環(huán)進(jìn)序列號(hào)必須和相對(duì)應(yīng)的命令的序列號(hào)相同。目前的短消息中心都具有對(duì)被叫用戶鑒權(quán)的功能，所以對(duì)由被叫方付費(fèi)的會(huì)通過(guò)反饋通知SMG。并由手機(jī)用戶A付費(fèi))時(shí)，應(yīng)該對(duì)付費(fèi)方進(jìn)行鑒權(quán)。這種情況下，該MT短消息應(yīng)該從付費(fèi)方歸屬地的短消息中心發(fā)送，并且由付費(fèi)方歸屬地的計(jì)費(fèi)中心完成送失敗的原因。SMG和計(jì)費(fèi)中心通過(guò)TCP/IP通信實(shí)現(xiàn)鑒權(quán)功能。計(jì)費(fèi)中心為服務(wù)器端，式訪問(wèn)這些URL。HTTP的特點(diǎn)決定客戶端和服務(wù)器端的每一次通信都必須一次完成授權(quán)連接、發(fā)送請(qǐng)求、接收應(yīng)答、關(guān)閉連接等過(guò)程(HTTP承載方式不再需SP和SMG之間的通信由客戶端向服務(wù)器端發(fā)起連接。連接建立以后，由客戶端向服務(wù)器端發(fā)送命令，服務(wù)器端必須對(duì)接收到的每一條命令返回一條應(yīng)答通信初始化客戶端有命令要向服務(wù)器端發(fā)送時(shí)，由客戶端首先通過(guò)Bind命令向服務(wù)器端發(fā)起連接。服務(wù)器端根據(jù)Bind命令之中的登錄名和密碼，對(duì)客戶端的合法性進(jìn)行驗(yàn)證，然后返回一條Bind_Resp應(yīng)答給客戶端。如果驗(yàn)證通過(guò)，則客戶端通信過(guò)程SP與SMG之間發(fā)送的任何一條命令都帶有一個(gè)序列號(hào)，序列號(hào)由命令源產(chǎn)客戶端與服務(wù)器端通信開(kāi)始以后，客戶端可以向服務(wù)器端發(fā)送相應(yīng)的命通信結(jié)束如果客戶端認(rèn)為和服務(wù)器端的通信已結(jié)束，則客戶端應(yīng)該向服務(wù)器端發(fā)送Unbind命令，服務(wù)器端隨后返回Unbind_Resp應(yīng)答，然后雙方斷開(kāi)連接。故障處理應(yīng)答相結(jié)合返回故障原因；如果MO不成功，該用戶所屬的SMG還應(yīng)向用戶終端客戶端應(yīng)該斷開(kāi)連接，然后嘗試重新向服務(wù)器端建立新的連接；服務(wù)器端應(yīng)該如果服務(wù)器端接收到的命令語(yǔ)法錯(cuò)誤，比如命等，則斷開(kāi)和客戶端的連接；客戶端應(yīng)該向服務(wù)器端建立新如果命令的序列號(hào)和以前接收到的命令的序列號(hào)相同，且命令內(nèi)容也相Bind端Report_RespBind端端端端端端實(shí)現(xiàn)命令的路由。兩個(gè)SMG互為客戶端和服務(wù)器端，SMG與SMG通信時(shí)，由客戶端首先通過(guò)Bind命令向服務(wù)器端發(fā)起連接。服務(wù)器端根據(jù)Bind命令之中的登錄名和密碼，對(duì)客戶端的合法性進(jìn)行驗(yàn)證，然后返回一條Bind_Resp應(yīng)答給客戶端。如果驗(yàn)證通過(guò)，則客戶端和服務(wù)器端的通如果客戶端認(rèn)為和服務(wù)器端的通信已結(jié)束，則客戶端應(yīng)該向服務(wù)器端發(fā)送Unbind命令，服務(wù)器端隨后返回Unbind_Resp應(yīng)答B(yǎng)ind客戶端向服務(wù)器端請(qǐng)求連接Bind_Resp服務(wù)器端對(duì)接收到的Bind命Submit_Resp服務(wù)器端向從客戶端接收到的Submit命令發(fā)送的應(yīng)答消息Deliver_Resp服務(wù)器端向從客戶端接收到的Deliver命令發(fā)送的應(yīng)答消息Report客戶端向服務(wù)器端發(fā)送一條MT或MO的發(fā)送結(jié)果Report_Resp服務(wù)器端向從客戶端接收到的Report命令發(fā)送應(yīng)答消息UserRpt_Resp服務(wù)器端向從客戶端接收到的UserRpt命令發(fā)送應(yīng)答消息Trace客戶端向服務(wù)器端發(fā)送請(qǐng)求跟蹤某一條MT短消息狀態(tài)的信息Trace_Resp服務(wù)器端向從客戶端接收到的Trace命令發(fā)送應(yīng)答消息立連接來(lái)完成路由表的更新和維護(hù)。當(dāng)SMG對(duì)本地的路由表作修改后，需要主SMG與GNS通信時(shí)，由客戶端首先通過(guò)Bind命令向服務(wù)器端發(fā)起連接。服務(wù)器端根據(jù)Bind命令之中的登錄名和密碼，對(duì)客戶端的合法性進(jìn)行驗(yàn)證，然后返回一條Bind_Resp應(yīng)答給客戶端。如果驗(yàn)證通過(guò)，則客戶端和服務(wù)器端的通客戶端和服務(wù)器端建立連接以后，客戶端向服務(wù)器端發(fā)送命令，服務(wù)器端如果客戶端認(rèn)為和服務(wù)器端的通信已結(jié)束，則客戶端應(yīng)該向服務(wù)器端發(fā)送Unbind命令，服務(wù)器端隨后返回Unbind_Resp應(yīng)答pp適用方式Bind適用方式Bindpp消息定義系統(tǒng)中的消息分三種：基于HTTP的消息、基于TCP/IP的消息和鑒權(quán)消息，系統(tǒng)中每個(gè)消息包最大不超過(guò)2K字節(jié)。Submit命令的請(qǐng)求內(nèi)容序列號(hào)，十六進(jìn)制數(shù)字計(jì)費(fèi)類(lèi)型，字符CommandId*SequenceNumberSPNumberChargeNumberUserNumberFeeType*FeeValueAgentFlagPriorityExpireTime短消息壽命的終止時(shí)間，如果為空，表示使用短消息中心的缺省“tnnp”取固定值“032+”，即默認(rèn)系統(tǒng)為北京時(shí)間“tnnp”取固定值“032+”，即默認(rèn)系統(tǒng)為北京時(shí)間1-該條消息無(wú)論最后是否成功都要返回狀態(tài)報(bào)告3-該條消息僅攜帶包月計(jì)費(fèi)信息，不下發(fā)給用戶，要返回狀態(tài)報(bào)告Submit命令的應(yīng)答內(nèi)容SequenceNumber的特服號(hào)，判斷出該服務(wù)屬于和哪一個(gè)SMG相連接的SP，如果屬于本地SP，則Deliver命令的請(qǐng)求內(nèi)容序列號(hào)，十六進(jìn)制數(shù)字Deliver命令的應(yīng)答內(nèi)容序列號(hào)，十六進(jìn)制數(shù)字SequenceNumberUserNumberSequenceNumberReport命令的請(qǐng)求內(nèi)容序列號(hào)，十六進(jìn)制數(shù)字SequenceNumberSubmitSequenceNumberReport命令的應(yīng)答內(nèi)容SequenceNumber序列號(hào)，十六進(jìn)制數(shù)字UserRpt命令用于在完成對(duì)用戶鑒權(quán)后，由SMG向手機(jī)用戶所注冊(cè)的SP發(fā)UserRpt命令的請(qǐng)求內(nèi)容SequenceNumber序列號(hào)，十六進(jìn)制數(shù)字SPNumberUserNumber待配置的手機(jī)號(hào)碼，字符，手機(jī)號(hào)碼前加“86”UserConditionUserRpt命令的應(yīng)答內(nèi)容序列號(hào)，十六進(jìn)制數(shù)字SequenceNumberTrace命令用于向SMG請(qǐng)求跟蹤某一條MT短消息的狀態(tài)。Trace命令的請(qǐng)求內(nèi)容SequenceNumber序列號(hào)，十六進(jìn)制數(shù)字SubmitSequenceNumberTrace命令的應(yīng)答內(nèi)容SequenceNumber序列號(hào)，十六進(jìn)制數(shù)字被跟蹤MT短消息經(jīng)過(guò)的節(jié)點(diǎn)個(gè)數(shù)，當(dāng)被跟蹤短消息經(jīng)過(guò)多個(gè)節(jié)點(diǎn)被跟蹤的短消息到達(dá)該節(jié)點(diǎn)時(shí)刻，格式為“yymmddhhmmss”該節(jié)點(diǎn)發(fā)出被跟蹤的短消息時(shí)刻，格式為“yymmddhhmmss”保留，擴(kuò)展用，當(dāng)被跟蹤短消息經(jīng)過(guò)多個(gè)節(jié)點(diǎn)時(shí)，以上各個(gè)字段消息中利用到如下數(shù)據(jù)類(lèi)型Text定長(zhǎng)字符串，左對(duì)齊存儲(chǔ)，空余位置補(bǔ)’\0’MessageLength44Bind操作Bind操作由Bind命令和Bind_Resp應(yīng)答組成?？蛻舳耸紫劝l(fā)送Bind命令，服務(wù)器端收到Bind命令后，對(duì)命令發(fā)送方進(jìn)行驗(yàn)證，然后返回Bind_Resp護(hù)1LoginType818Unbind操作Unbind操作由Unbind命令和Unbind_Resp應(yīng)答組成。通信連接建立以后，客戶端如果要停止通信，需要發(fā)送Unbind命令；服務(wù)器端收到Unbind命令后，向客戶端發(fā)送Unbind_Resp相應(yīng)，然后雙方斷開(kāi)連接。Submit操作Submit命令中的付費(fèi)號(hào)碼，判斷出該命令是否應(yīng)從本地SMSC發(fā)送，如果屬于本地發(fā)送，則直接發(fā)送到相應(yīng)的SMSC，否則路由至相應(yīng)的SMG。收到的MT短消息。服務(wù)器端接收到Submit命令后，再發(fā)送到與之相連的目的付費(fèi)號(hào)碼，手機(jī)號(hào)碼前加“86”國(guó)別標(biāo)志；當(dāng)且僅當(dāng)群發(fā)且對(duì)用戶收費(fèi)時(shí)為空；如果為空，則該條短接收該短消息的手機(jī)號(hào)，該字段重復(fù)UserC…對(duì)于包月制收費(fèi)的用戶，該值為月租費(fèi)的值費(fèi)FeeType1GivenValue6…UserCount1ChargeNumber21AgentFlag1Priority1為”yymmddhhmmsstnnp”，其中“tnnp”11-該條消息無(wú)論最后是否成功都要返回狀態(tài)報(bào)告1111MessageLength4MessageContentMessage8188Deliver操作的特服號(hào)，判斷出該服務(wù)屬于和哪一個(gè)SMG相連接的SP，如果屬于本地SP，則短消息。服務(wù)器端接收到Deliver命令后，再發(fā)送到與之相連的目的SP。UserNumberSPNumber1114MessageContentMessage818Report操作Report命令用于向SP發(fā)送一條先前的Submit命令的當(dāng)前狀態(tài)，或者用于要向發(fā)送方返回Report_Resp命令。接收短消息的手機(jī)號(hào)，手機(jī)號(hào)碼前加“86”國(guó)別標(biāo)志118Reserve8TeAddSP操作6SPNumberServiceTagCorpId5Reserve8Te18ModifySP操作6OldServiceTagNewServiceTag58Reserve8TeDeleteSP操作6SPNumberServiceTag818QueryRoute操作QueryRoute操作用于在SMG向GNS請(qǐng)求一條或全部路由信息。左對(duì)齊，剩余部分填’\0’業(yè)務(wù)代碼，該字段為空時(shí)不考慮業(yè)務(wù)代碼，請(qǐng)ServiceTag8左對(duì)齊，剩余部分填’\0’56484AddTeleSeg操作AddTeleSeg操作用于在GNS向SMG通知添加了一個(gè)號(hào)碼段。TeleTypeReserve674818ModifyTeleSeg操作ModifyTeleSeg操作用于在GNS向SMG通知修改了一個(gè)號(hào)碼段。67NewTeleSeg714818DeleteTeleSeg操作DeleteTeleSeg操作用于在GNS通知SMG刪除了一個(gè)號(hào)碼段。67818AddSMG操作64818ModifySMG操作6NewSMGId64818DeleteSMG操作6818待鑒權(quán)的手機(jī)號(hào)碼，手機(jī)號(hào)碼前加“86”國(guó)別818待配置的手機(jī)號(hào)碼，手機(jī)號(hào)碼前加“86”國(guó)別SPNumberUserNumberUserCondition18Reserve8TeSubmitSequenceUserNumber“86”國(guó)別標(biāo)志8“yymmddhhmmss”“yymmddhhmmss”68SGIP_BINDSGIP_MODIFYTELESEG_RESPSGIP_DELETETELESEG_RESP5參數(shù)格式錯(cuò)，指命令中參數(shù)值與參數(shù)類(lèi)型不符或與協(xié)議規(guī)定的范圍6非法手機(jī)號(hào)碼，協(xié)議中所有手機(jī)號(hào)碼字段出現(xiàn)非86130號(hào)碼或手機(jī)9非法序列號(hào)，包括序列號(hào)重復(fù)、序列號(hào)格式錯(cuò)誤等況