




版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進(jìn)行舉報(bào)或認(rèn)領(lǐng)
文檔簡介
本文格式為Word版,下載可任意編輯——短消息業(yè)務(wù)聯(lián)網(wǎng)協(xié)議12版(SGIP協(xié)議)
附件一:
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議
(SGIP)
版本1.2
中國聯(lián)合通信公司
二零零一年十月
目錄
1概述11.1協(xié)議說明11.2適用范圍11.3參考資料11.4術(shù)語表12系統(tǒng)體系結(jié)構(gòu)32.1消息從本地SMSC到本地SP42.2消息從本地SP到本地SMSC42.3消息從本地SMSC到異地SP42.4消息從本地SP到異地SMSC42.5路由選擇43
通信流程63.1專用SGIP方式63.2通用HTTP方式63.3通信節(jié)點(diǎn)編號規(guī)則73.4序列號的定義73.5通信的安全性83.6用戶鑒權(quán)83.6.1被叫方付費(fèi)83.6.2SP付費(fèi)83.6.3第三方付費(fèi)83.7SP與SMG的通信93.7.1通用HTTP方式9從SP到SMG的命令9從SMG到SP的命令103.7.2專用SGIP方式10通信初始化10通信過程10通信終止11故障處理12從SP到SMG的消息12從SMG到SP的消息133.8SMG與SMG之間的通信133.8.1通信初始化143.8.2通信過程143.8.3通信終止143.8.4故障處理143.8.5兩個SMG之間的消息153.9SMG與GNS之間的通信153.9.1通信初始化15
i
3.9.2通信過程153.9.3通信終止163.9.4故障處理163.9.5從SMG到GNS的消息163.9.6從GNS到SMG的消息164
消息定義184.1基于通用HTTP的消息定義184.1.1Submit操作18Submit命令的請求內(nèi)容18Submit命令的應(yīng)答內(nèi)容194.1.2Deliver操作20Deliver命令的請求內(nèi)容20Deliver命令的應(yīng)答內(nèi)容204.1.3Report操作21Report命令的請求內(nèi)容21Report命令的應(yīng)答內(nèi)容214.1.4UserRpt操作22UserRpt命令的請求內(nèi)容22UserRpt命令的應(yīng)答內(nèi)容224.1.5Trace操作22Trace命令的請求內(nèi)容22Trace命令的應(yīng)答內(nèi)容234.2基于專用SGIP的消息定義234.2.1數(shù)據(jù)類型234.2.2消息頭的格式244.2.3消息體的格式24Bind操作24Unbind操作25Submit操作25Deliver操作27Report操作28AddSP操作28ModifySP操作29DeleteSP操作30QueryRoute操作300AddTeleSeg操作311ModifyTeleSeg操作322DeleteTeleSeg操作323AddSMG操作334ModifySMG操作345DeleteSMG操作344.3鑒權(quán)消息定義354.3.1CheckUser命令的語法35
ii
4.3.2CheckUser_Resp應(yīng)答的語法354.3.3UserRpt命令的語法354.3.4UserRpt_Resp應(yīng)答的語法354.4測試消息定義364.4.1Trace命令的語法364.4.2Trace_Resp應(yīng)答的語法365常量定義375.1消息ID定義375.2錯誤碼定義375.3計(jì)費(fèi)類別定義385.4REPORT狀態(tài)與短消息狀態(tài)的映射38附錄1:全網(wǎng)路由表的格式示范39附錄2:本地路由表的格式示范40附錄3:HTTP承載方式示范41
iii
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版1概述
1.1協(xié)議說明
本協(xié)議是SMG和SP之間、SMG和GNS之間、以及SMG和SMG之間的接口協(xié)議,簡稱SGIP。
通過應(yīng)用SGIP協(xié)議,SP可以接入到SMG,實(shí)現(xiàn)SP應(yīng)用的一點(diǎn)接入、全網(wǎng)服務(wù);SMG可以通過SGIP協(xié)議,實(shí)現(xiàn)消息在不同SMG之間的路由和轉(zhuǎn)發(fā)。同時,SMG通過該協(xié)議也可以和GNS通信,以實(shí)現(xiàn)各SMG和GNS之間路由表的同步功能。
1.2適用范圍
本協(xié)議適用于各SP廠商和SMG的開發(fā)廠商。
1.3參考資料
[1][2][3][4]
SMPP3.3GSM3.40GSM3.38HTTP1.0
1.4術(shù)語表
本協(xié)議用到以下術(shù)語:
GNSMOMTSGIP
GatewayNameServer,負(fù)責(zé)系統(tǒng)路由的管理和同步由手機(jī)用戶提交的短消息由手機(jī)用戶接收的短消息
ShortMessageGatewayInterfaceProtocol,本協(xié)議所描述的短消息網(wǎng)關(guān)接口協(xié)議,用于完成在SMG和SP之間、SMG和SMG之間短消息的發(fā)送、接收和轉(zhuǎn)發(fā)功能,以及SMG和GNS之間路由表的同步功能
SMG
ShortMessageGateway,聯(lián)通公司的短消息網(wǎng)關(guān),SMG之間的通訊協(xié)議采用SGIP
1
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版SMPPSMSCSP
ShortMessagePeertoPeer,短消息點(diǎn)對點(diǎn)協(xié)議,采用3.3版本ShortMessageServiceCenter,短消息中心ServiceProvider,服務(wù)提供商
2
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版2系統(tǒng)體系結(jié)構(gòu)
SMG是具有短消息轉(zhuǎn)發(fā)功能的短消息網(wǎng)關(guān)。全國可以有多個SMG網(wǎng)關(guān),SMG網(wǎng)關(guān)之間通過互聯(lián)網(wǎng)等方式實(shí)現(xiàn)網(wǎng)絡(luò)互聯(lián)。每一個SMG同時與多個SMSC以及多個SP連接。全網(wǎng)具有唯一有效的GNS,GNS負(fù)責(zé)全局路由表的維護(hù)與更新;為了確保路由表存儲的安全性,網(wǎng)絡(luò)中設(shè)置主備用GNS,兩個GNS要保持一致性。每一個SMG都和GNS連接。SMG與SP、SMG與GNS以及SMG與SMG之間的通信協(xié)議為SGIP協(xié)議。SMG與SMSC之間的通信統(tǒng)一采用SMPP3.3協(xié)議。
圖2-1說明白系統(tǒng)的體系結(jié)構(gòu)。
圖2-1SMG的體系結(jié)構(gòu)
和SMG平臺之間相連的SMSC稱作本地SMSC,和異地SMG平臺相連的SMSC稱作異地SMSC。
和SMG平臺之間相連的SP稱作本地SP,和異地SMG平臺相連的SP稱作異地SP。
從本地SMSC向本地SP以及從本地SP向本地SMSC發(fā)送的消息直接由SMG轉(zhuǎn)發(fā);從本地SMSC向異地SP以及從本地SP向異地SMSC發(fā)送的消息由本地SMG路由到異地SMG后,再由異地SMG轉(zhuǎn)發(fā)。
3
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版2.1消息從本地SMSC到本地SP
SMG從SMSC接收到短消息,直接發(fā)給SP。譬如SMSC1A—〉SMG1—〉SP1YSMSC1B—〉SMG1—〉SP1X
2.2消息從本地SP到本地SMSC
SMG從SP接收短消息,直接發(fā)給SMSC。譬如SP1X—〉SMG1—〉SMSC1ASP1Y—〉SMG1—〉SMSC1B
2.3消息從本地SMSC到異地SP
SMG從本地SMSC接收短消息,再路由到異地SMG,由異地的SMG發(fā)送到目的SP,譬如
SMSC1A—〉SMG1—〉SMG2—〉SP2Y
SMSC1B—〉SMG1—〉SMG3—〉SP3X
2.4消息從本地SP到異地SMSC
SMG從本地SP接收短消息,再路由到異地SMG,由異地的SMG發(fā)送到目的SMSC,譬如
SP1X—〉SMG1—〉SMG2—〉SMSC2ASP1Y—〉SMG1—〉SMG3—〉SMSC3B
2.5路由選擇
當(dāng)消息在本地SMSC和異地SP,或者在本地SP和異地SMSC之間傳輸時,發(fā)送方必需要獲取消息接收方的位置信息。這部分功能稱為路由選擇。對于MO方向的命令(即命令接收方為SP),其路由根據(jù)命令中的SP接入號碼來選擇。
對于MT方向的命令(即接收方為用戶手機(jī)),其路由根據(jù)命令中的付費(fèi)號碼和用戶號碼來綜合判斷。假使付費(fèi)號碼為空,或付費(fèi)號碼為SP接入號碼,則根據(jù)用戶號碼來選擇路由;否則根據(jù)付費(fèi)號碼所代表的手機(jī)號碼來選擇路由(這樣
4
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版做是考慮到了系統(tǒng)計(jì)費(fèi)和用戶鑒權(quán)的可行性,關(guān)于計(jì)費(fèi)和用戶鑒權(quán)的細(xì)節(jié),請參見其它文檔)。
由于SMG網(wǎng)關(guān)之間采用網(wǎng)狀互聯(lián),網(wǎng)關(guān)之間不可能出現(xiàn)二次前轉(zhuǎn),因此接收前轉(zhuǎn)消息的網(wǎng)關(guān)必需能判斷前轉(zhuǎn)的消息目的地址是否是本網(wǎng)關(guān)覆蓋范圍的用戶,若不是,必需發(fā)送出錯信息到前轉(zhuǎn)網(wǎng)關(guān)。
5
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版3通信流程
SGIP有兩種具體實(shí)現(xiàn)方式,一種是采用專用SGIP方式,另一種是采用通用HTTP方式。SMG和GNS、以及SMG和SMG之間采用專用SGIP方式作為承載協(xié)議;而SP和SMG的通信同時支持專用SGIP方式和通用HTTP方式兩種承載協(xié)議。
3.1專用SGIP方式
采用專用SGIP方式承載時,通信雙方互為客戶端和服務(wù)器端。當(dāng)客戶端要發(fā)送命令時,主動向服務(wù)器端建立連接,然后向服務(wù)器端發(fā)送命令,并接收應(yīng)答;服務(wù)器端從客戶端接收命令,返回應(yīng)答。連接建立以后,客戶端可以連續(xù)發(fā)送多條命令。命令發(fā)送完并接收到所有應(yīng)答后,客戶端應(yīng)當(dāng)主動斷開連接。但是,命令及其應(yīng)答之間的時間間隔最大不能超過30秒(默認(rèn),可配置)(假使命令應(yīng)答時間超過最大等待時間,則要求客戶端重發(fā)該條命令,重發(fā)機(jī)制參見業(yè)務(wù)聯(lián)網(wǎng)規(guī)范有關(guān)內(nèi)容),且待應(yīng)答的命令不得超過32條(可以根據(jù)線路的質(zhì)量和服務(wù)器的處理能力配置)。而且,假使服務(wù)器端檢測出一條連接長時間空閑(默認(rèn)60秒,可配置),可以主動斷開該連接。假使需要,客戶端可以同時向一個服務(wù)器端建立多個連接(SMG與單個其他SMG最多不能建立超過15個連接,對與之相連的單個SP的最大連接數(shù)視具體狀況而定)。采用專用SGIP承載方式時,SMG和SMG、SP和SMG之間使用的端口號是8801,GNS監(jiān)聽SMG的端口號為8802,SMG監(jiān)聽GNS的端口號為8803,主GNS和備用GNS之間的端口號為8804,SMG之間的測試用端口號為8810。
3.2通用HTTP方式
HTTP承載方式只適用于SP和SMG的通信中。與SP與SMG之間的專用SGIP承載方式不同的是,該種方式一次連接僅僅傳送一條命令,而且連接的認(rèn)證采用HTTP的URL的授權(quán)認(rèn)證的方式,不需要專門的連接認(rèn)證的命令,使用的端口號是80。
6
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版3.3通信節(jié)點(diǎn)編號規(guī)則
在整個網(wǎng)關(guān)系統(tǒng)中,所有的通信節(jié)點(diǎn)(SMG、GNS、SP和SMSC)都有一個唯一的數(shù)字編號,不同的SP或SMSC或SMG或GNS編號不能一致,編號由系統(tǒng)管理人員負(fù)責(zé)分派。編號規(guī)則如下:
SMG的編號規(guī)則:1AAAAXSMSC的編號規(guī)則:2AAAAXSP的編號規(guī)則:3AAAAQ
GNS的編號規(guī)則:4AAAAX
其中,AAAA表示四位長途區(qū)號(不足四位的長途區(qū)號,左對齊,右補(bǔ)零),X表示1位序號,Q表示5位企業(yè)代碼。
3.4序列號的定義
短消息網(wǎng)關(guān)系統(tǒng)之中傳輸?shù)拿恳粭l命令都有一個序列號,序列號由命令源節(jié)點(diǎn)產(chǎn)生并唯一標(biāo)記一條命令;也就是說,網(wǎng)關(guān)系統(tǒng)中任何兩個命令的序列號都不一致。需要注意的是,一條命令在發(fā)送過程中轉(zhuǎn)發(fā)的不同副本視為一條命令,使用一致的序列號。譬如,SP1X向SMSC2A發(fā)送一條命令,該命令需經(jīng)過屢屢轉(zhuǎn)發(fā)才能到達(dá)SMSC2A,而轉(zhuǎn)發(fā)該命令的每一次通信過程中使用的命令的序號均一致,為SP1X與SMG1通信所使用的序列號。對于MO短消息,例如SMSC1B向SP3X發(fā)送一條命令,短消息首先采用SMPP協(xié)議發(fā)送到SMG1,經(jīng)過SMG1轉(zhuǎn)發(fā)時序列號必需由SMG1重新生成(此時命令源節(jié)點(diǎn)為SMG1)。
序列號分成三部分,每部分為一個32位整數(shù),第一部分表示命令源節(jié)點(diǎn)的編號,其次部分表示命令產(chǎn)生的日期和時間(網(wǎng)關(guān)系統(tǒng)中的任何命令的保存時間都不應(yīng)當(dāng)超過一年),格式為十進(jìn)制的mmddhhmmss,譬如11月20日20時32分25秒產(chǎn)生的命令,其其次部分為十進(jìn)制1120233225;第三部分由0開始,循環(huán)進(jìn)位,直到進(jìn)位滿了之后再清零,重新開始計(jì)數(shù)。接收方在返回應(yīng)答時,應(yīng)答的序列號必需和相對應(yīng)的命令的序列號一致。
7
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版圖3-1命令序列號格式舉例
3.5通信的安全性
SP與SMG、SMG與SMG以及SMG與GNS之間采用專用SGIP方式通信時可采用對稱加密方式。SP與SMG之間采用通用HTTP方式時,可采用HTTPS方式加密。
3.6用戶鑒權(quán)
當(dāng)一條MT短消息需要處理時,終點(diǎn)SMG必需保證該短消息的付費(fèi)方有資格享用該服務(wù)(譬如付費(fèi)用戶不欠費(fèi))。根據(jù)短消息服務(wù)類型的不同,可以將付費(fèi)方式分成三類:被叫方付費(fèi)、SP付費(fèi)和第三方付費(fèi)。
3.6.1被叫方付費(fèi)
目前的短消息中心都具有對被叫用戶鑒權(quán)的功能,所以對由被叫方付費(fèi)的MT短消息,SMG不作鑒權(quán)檢查,直接轉(zhuǎn)發(fā)至SMSC;假使被叫方鑒權(quán)失敗,SMSC會通過反饋通知SMG。
3.6.2SP付費(fèi)
當(dāng)MT短消息是由SP付費(fèi)時(如SP發(fā)送廣告),SMG不作鑒權(quán)檢查。
3.6.3第三方付費(fèi)
當(dāng)MT短消息是由第三方付費(fèi)(如手機(jī)用戶A通過SP給手機(jī)用戶B點(diǎn)歌,并由手機(jī)用戶A付費(fèi))時,應(yīng)當(dāng)對付費(fèi)方進(jìn)行鑒權(quán)。這種狀況下,該MT短消息應(yīng)當(dāng)從付費(fèi)方歸屬地的短消息中心發(fā)送,并且由付費(fèi)方歸屬地的計(jì)費(fèi)中心完成鑒權(quán)操作。假使計(jì)費(fèi)中心鑒權(quán)成功,SMG即將該MT短消息發(fā)送至SMSC,否則SMG不再發(fā)送該短消息,并根據(jù)SP的要求決定是否返回Report命令通知SP發(fā)送失敗的原因。
SMG和計(jì)費(fèi)中心通過TCP/IP通信實(shí)現(xiàn)鑒權(quán)功能。計(jì)費(fèi)中心為服務(wù)器端,SMG為客戶端。一次鑒權(quán)過程完成對一個手機(jī)號碼的鑒權(quán)。鑒權(quán)步驟如下:
1.SMG和計(jì)費(fèi)中心建立TCP/IP連接;
2.
SMG向計(jì)費(fèi)中心發(fā)送鑒權(quán)命令;
8
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版3.4.消息CheckUserCheckUser_RespSMG從計(jì)費(fèi)中心接收鑒權(quán)應(yīng)答;SMG和計(jì)費(fèi)中心斷開連接;
描述SMG向計(jì)費(fèi)中心請求對一個手機(jī)號碼鑒權(quán)計(jì)費(fèi)中心向SMG返回的一個手機(jī)號碼的鑒權(quán)結(jié)果表3-1SMG和計(jì)費(fèi)中心的鑒權(quán)消息
3.7SP與SMG的通信
SP和SMG支持兩種類型的通信承載方式:通用HTTP承載方式和通用SGIP承載方式。
3.7.1通用HTTP方式
SP和SMG之間采用通用HTTP方式通信時,SP和SMG互為HTTP的客戶端和服務(wù)器端。HTTP服務(wù)器端對相關(guān)的URL進(jìn)行保護(hù),HTTP客戶端必需采用授權(quán)方式訪問這些URL。HTTP的特點(diǎn)決定客戶端和服務(wù)器端的每一次通信都必需一次完成授權(quán)連接、發(fā)送請求、接收應(yīng)答、關(guān)閉連接等過程(HTTP承載方式不再需要專門的連接命令)。
對于MO方向的命令(即命令接收方為SP),由SMG通過POST方式提交給SP進(jìn)行處理,SP將處理結(jié)果以及MT方向信息在HTTP應(yīng)答中返回給SMG;
對于SP主動向用戶發(fā)送信息的PUSH業(yè)務(wù),由SP作為客戶端將信息通過POST方式提交給SMG進(jìn)行處理,SMG在應(yīng)答中確認(rèn)信息發(fā)送成功與否。
由于HTTP服務(wù)器對URL進(jìn)行了授權(quán)保護(hù),所以HTTP客戶端必需在每次請求中都帶上授權(quán)信息。HTTP客戶端的一個請求只能攜帶一條命令。SP與SMG之間發(fā)送的任何一條命令都帶有一個序列號,序列號由命令源產(chǎn)生,任何兩條命令的序列號不能重復(fù)。
假使HTTP服務(wù)器接收到的HTTP請求內(nèi)容的格式不完整或不正確,HTTP服務(wù)器應(yīng)當(dāng)返回錯誤碼。
HTTP承載方式支持的HTTP協(xié)議為1.0版。
HTTP承載方式使用如下命令:
從SP到SMG的命令
消息SubmitTrace描述SP用該消息向SMG請求向某一個短消息用戶發(fā)送短消息SP用該消息向SMG請求跟蹤某一條MT短消息的狀態(tài)表3-2從SP到SMG的命令
9
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版從SMG到SP的命令
消息DeliverReportUserRpt描述SMG發(fā)送一條短消息到SPSMG用該命令通知SP一條Submit命令所發(fā)送的MT當(dāng)前結(jié)果SMG用該命令報(bào)告SP一條手機(jī)用戶的狀態(tài)表3-3從SMG到SP的命令
3.7.2專用SGIP方式
SP和SMG之間的通信由客戶端向服務(wù)器端發(fā)起連接。連接建立以后,由客戶端向服務(wù)器端發(fā)送命令,服務(wù)器端必需對接收到的每一條命令返回一條應(yīng)答消息。SP和SMG互為客戶端和服務(wù)器端。
通信初始化
客戶端有命令要向服務(wù)器端發(fā)送時,由客戶端首先通過Bind命令向服務(wù)器端發(fā)起連接。服務(wù)器端根據(jù)Bind命令之中的登錄名和密碼,對客戶端的合法性進(jìn)行驗(yàn)證,然后返回一條Bind_Resp應(yīng)答給客戶端。假使驗(yàn)證通過,則客戶端和服務(wù)器端的通信開始,否則中斷連接。
通信過程
SP與SMG之間發(fā)送的任何一條命令都帶有一個序列號,序列號由命令源產(chǎn)生。
客戶端與服務(wù)器端通信開始以后,客戶端可以向服務(wù)器端發(fā)送相應(yīng)的命令,服務(wù)器端對收到的命令返回應(yīng)答。
10
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版
圖3-2SP和SMG的通信消息樣例(SP為客戶端)
圖3-3SP和SMG的通信消息樣例(SMG為客戶端)
命令在SP和SMSC之間的傳輸是采用類似接力的方式,每條命令和對應(yīng)的應(yīng)答僅僅表示該次命令發(fā)送的結(jié)果是否正確。譬如,SP向某一個手機(jī)發(fā)送一條短消息,是通過向本地SMG發(fā)送一條Submit命令實(shí)現(xiàn)的,隨后,SP會從SMG接收到一條Submit_Resp應(yīng)答。但是,即使應(yīng)答表示Submit命令已正確接收,也不表示Submit命令內(nèi)的短消息已經(jīng)發(fā)送到手機(jī)上了,而僅僅表示該短消息已經(jīng)傳送到SMG,SMG將會作下一步處理,或者發(fā)送給SMSC,或者路由到另外的SMG,最終由目的SMSC發(fā)送到手機(jī)上。這中間任何一個環(huán)節(jié)出現(xiàn)錯誤,系統(tǒng)會終止信息的繼續(xù)發(fā)送,并且通過向原SP發(fā)送Report命令告訴發(fā)送出錯的原因(假使SP指定要求反饋的話)。
通信終止
假使客戶端認(rèn)為和服務(wù)器端的通信已終止,則客戶端應(yīng)當(dāng)向服務(wù)器端發(fā)送Unbind命令,服務(wù)器端隨后返回Unbind_Resp應(yīng)答,然后雙方斷開連接。
11
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版故障處理
發(fā)生故障時,SP、SMG以及GNS節(jié)點(diǎn)應(yīng)通過Report命令和其它相關(guān)命令的應(yīng)答相結(jié)合返回故障原因;假使MO不成功,該用戶所屬的SMG還應(yīng)向用戶終端返回友好的應(yīng)答信息說明不成功原因。
.1網(wǎng)絡(luò)故障
客戶端與服務(wù)器端的通信過程中假使檢測到雙方連接中斷(如網(wǎng)絡(luò)斷線),客戶端應(yīng)當(dāng)斷開連接,然后嘗試重新向服務(wù)器端建立新的連接;服務(wù)器端應(yīng)當(dāng)依照接收到Unbind的狀況進(jìn)行處理,斷開和客戶端的連接。
.2接收到非法命令或應(yīng)答
假使服務(wù)器端接收到的命令語法錯誤,譬如命令不完整、命令無法識別等,則斷開和客戶端的連接;客戶端應(yīng)當(dāng)向服務(wù)器端建立新連接繼續(xù)發(fā)送命令。
假使客戶端接收到的應(yīng)答語法錯誤,譬如命令不完整、命令無法識別等,則主動斷開和服務(wù)器端的連接;服務(wù)器端也應(yīng)當(dāng)斷開和客戶端的連接。
假使命令語法正確,但服務(wù)器端不處理該命令,譬如SP為服務(wù)器端時收到Submit命令,則返回相應(yīng)應(yīng)答,并在應(yīng)答中指定錯誤原因。
假使應(yīng)答語法正確,但客戶端不處理該應(yīng)答,譬如SP為客戶端時收到Deliver_Resp應(yīng)答,則丟棄。
.3序列號重復(fù)
假使命令的序列號和以前接收到的命令的序列號一致,且命令內(nèi)容也一致,則接收方丟棄該命令;假使序列號一致,但是命令內(nèi)容并不一致,則命令接收方在應(yīng)答中返回錯誤碼。
從SP到SMG的消息
消息BindBind_RespUnbindUnbind_Resp適用方式SP為客戶端SP為服務(wù)器SP為客戶端SP為服務(wù)器描述SP用該消息向SMG發(fā)出建立連接的請求SP對Bind命令的應(yīng)答SP用該消息向SMG通知將要斷開現(xiàn)有的連接SP對Unbind命令的應(yīng)答
12
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版SubmitDeliver_RespReport_RespUserRpt_RespTraceSP為客戶端SP為服務(wù)器端SP為服務(wù)器SP為服務(wù)器SP為客戶端SP用該消息向SMG請求發(fā)送短消息SP用該消息對從SMG接收到的Deliver命令作出應(yīng)答SP對從SMG接收到的Report命令作出應(yīng)答SP對從SMG接收到的UserRpt命令作出應(yīng)答SP用該消息向SMG請求跟蹤某一條MT短消息的狀態(tài)表3-4從SP到SMG的消息
從SMG到SP的消息
消息BindBind_RespUnbindUnbind_RespSubmit_RespDeliverReportUserRptTrace_Resp適用方式SMG為客戶端SMG為服務(wù)器端SMG為客戶端SMG為服務(wù)器端SMG為服務(wù)器端SMG為客戶端SMG為客戶端SMG為客戶端SMG為客戶端描述SMG用該消息向SP發(fā)出建立連接的請求SMG對Bind命令的應(yīng)答SMG用該消息向SP通知將要斷開現(xiàn)有的連接SMG對Unbind命令的應(yīng)答SMG對Submit命令的應(yīng)答SMG發(fā)送一條短消息到SPSMG用該命令通知SP一條Submit命令所發(fā)送的MT當(dāng)前結(jié)果SMG用該命令通知SP一條手機(jī)用戶的狀態(tài)信息SMG對Trace命令的應(yīng)答表3-5從SMG到SP的消息
3.8SMG與SMG之間的通信
在網(wǎng)關(guān)系統(tǒng)之中,任何兩個SMG之間都要建立一對基于TCP/IP的連接,以實(shí)現(xiàn)命令的路由。兩個SMG互為客戶端和服務(wù)器端,客戶端向服務(wù)器端發(fā)送命令,接收應(yīng)答;服務(wù)器端從客戶端接收命令,返回應(yīng)答。
13
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版
圖3-4SMG之間的通信消息樣例
3.8.1通信初始化
SMG與SMG通信時,由客戶端首先通過Bind命令向服務(wù)器端發(fā)起連接。服務(wù)器端根據(jù)Bind命令之中的登錄名和密碼,對客戶端的合法性進(jìn)行驗(yàn)證,然后返回一條Bind_Resp應(yīng)答給客戶端。假使驗(yàn)證通過,則客戶端和服務(wù)器端的通信開始,否則中斷連接。
3.8.2通信過程
兩個SMG之間的通信和SP和SMG之間的基于TCP/IP的承載方式的通信方式一致。
3.8.3通信終止
假使客戶端認(rèn)為和服務(wù)器端的通信已終止,則客戶端應(yīng)當(dāng)向服務(wù)器端發(fā)送Unbind命令,服務(wù)器端隨后返回Unbind_Resp應(yīng)答,然后雙方斷開連接。
3.8.4故障處理
SMG之間的故障處理和SP與SMG之間的故障處理一致。
14
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版3.8.5兩個SMG之間的消息
消息BindBind_RespUnbindUnbind_RespSubmitSubmit_RespDeliverDeliver_RespReportReport_RespUserRptUserRpt_RespTraceTrace_Resp描述客戶端向服務(wù)器端請求連接服務(wù)器端對接收到的Bind命令的響應(yīng)客戶端向服務(wù)器端通知斷開當(dāng)前的連接服務(wù)器端對接收到的Unbind命令的響應(yīng)客戶端向服務(wù)器端發(fā)送一條MT短消息服務(wù)器端向從客戶端接收到的Submit命令發(fā)送的應(yīng)答消息客戶端向服務(wù)器端發(fā)送一條MO短消息服務(wù)器端向從客戶端接收到的Deliver命令發(fā)送的應(yīng)答消息客戶端向服務(wù)器端發(fā)送一條MT或MO的發(fā)送結(jié)果服務(wù)器端向從客戶端接收到的Report命令發(fā)送應(yīng)答消息客戶端向服務(wù)器端發(fā)送一條手機(jī)用戶的狀態(tài)信息服務(wù)器端向從客戶端接收到的UserRpt命令發(fā)送應(yīng)答消息客戶端向服務(wù)器端發(fā)送請求跟蹤某一條MT短消息狀態(tài)的信息服務(wù)器端向從客戶端接收到的Trace命令發(fā)送應(yīng)答消息表3-6SMG之間的消息
3.9SMG與GNS之間的通信
在網(wǎng)關(guān)系統(tǒng)之中,任何一個SMG都要和GNS以互為客戶端/服務(wù)器的方式建立連接來完成路由表的更新和維護(hù)。當(dāng)SMG對本地的路由表作修改后,需要主動以客戶端的身份向GNS建立連接,通知GNS更新路由表;當(dāng)GNS修改了路由表后,需要主動以客戶端的身份向所有的SMG建立連接,通知SMG更新路由表。
3.9.1通信初始化
SMG與GNS通信時,由客戶端首先通過Bind命令向服務(wù)器端發(fā)起連接。服務(wù)器端根據(jù)Bind命令之中的登錄名和密碼,對客戶端的合法性進(jìn)行驗(yàn)證,然后返回一條Bind_Resp應(yīng)答給客戶端。假使驗(yàn)證通過,則客戶端和服務(wù)器端的通信開始,否則中斷連接。
3.9.2通信過程
客戶端和服務(wù)器端建立連接以后,客戶端向服務(wù)器端發(fā)送命令,服務(wù)器端則返回應(yīng)答。
15
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版3.9.3通信終止
假使客戶端認(rèn)為和服務(wù)器端的通信已終止,則客戶端應(yīng)當(dāng)向服務(wù)器端發(fā)送Unbind命令,服務(wù)器端隨后返回Unbind_Resp應(yīng)答,然后雙方斷開連接。
3.9.4故障處理
SMG和GNS的故障處理和SP與SMG之間的故障處理一致。
3.9.5從SMG到GNS的消息
適用方式BindSMG為客戶端Bind_RespSMG為服務(wù)器端UnbindSMG為客戶端Unbind_RespSMG為服務(wù)器端AddSPSMG為客戶端AddSP_RespSMG為服務(wù)器端ModifySPSMG為客戶端ModifySP_RespSMG為服務(wù)器端DeleteSPSMG為客戶端DeleteSP_RespSMG為服務(wù)器端AddTeleSegSMG為客戶端AddTeleSeg_RespSMG為服務(wù)器端ModifyTeleSegSMG為客戶端ModifyTeleSeg_RespSMG為服務(wù)器端DeleteTeleSegSMG為客戶端DeleteTeleSeg_RespSMG為服務(wù)器端QueryRouteSMG為客戶端QueryRoute_RespSMG為服務(wù)器端消息描述SMG向GNS端請求連接SMG對Bind命令的應(yīng)答SMG向GNS端通知斷開當(dāng)前的連接SMG對Unbind命令的應(yīng)答SMG通知GNS添加了一個SPSMG對AddSP命令的應(yīng)答SMG通知GNS修改了一個SPSMG對ModifySP命令的應(yīng)答SMG通知GNS刪除了一個SPSMG對DeleteSP命令的應(yīng)答SMG通知GNS添加了一個號碼段SMG對AddTeleSeg命令的應(yīng)答SMG通知GNS修改了一個號碼段SMG對ModifyTeleSeg命令的應(yīng)答SMG通知GNS刪除了一個號碼段SMG對DeleteTeleSeg命令的應(yīng)答SMG向GNS請求一個手機(jī)號或接入號碼的路由信息,或全部路由表信息SMG對QueryRoute命令的應(yīng)答表3-7從SMG到GNS的消息
3.9.6從GNS到SMG的消息
消息BindBind_RespUnbindUnbind_RespAddSPAddSP_RespModifySPModifySP_RespDeleteSPDeleteSP_RespAddTeleSeg適用方式GNS為客戶端GNS為服務(wù)器端GNS為客戶端GNS為服務(wù)器端GNS為客戶端GNS為服務(wù)器端GNS為客戶端GNS為服務(wù)器端GNS為客戶端GNS為服務(wù)器端GNS為客戶端描述GNS向SMG端請求連接GNS對Bind命令的應(yīng)答GNS向SMG端通知斷開當(dāng)前的連接GNS對Unbind命令的應(yīng)答GNS通知SMG添加了一個SPGNS對AddSP命令的應(yīng)答GNS通知SMG修改了一個SPGNS對ModifySP命令的應(yīng)答GNS通知SMG刪除了一個SPGNS對DeleteSP命令的應(yīng)答GNS通知SMG添加了一個號碼段
16
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版AddTeleSeg_RespGNS為服務(wù)器端GNS對AddTeleSeg命令的應(yīng)答ModifyTeleSegGNS為客戶端GNS通知SMG修改了一個號碼段ModifyTeleSeg_RespGNS為服務(wù)器端GNS對ModifyTeleSeg命令的應(yīng)答DeleteTeleSegGNS為客戶端GNS通知SMG刪除了一個號碼段DeleteTeleSeg_RespGNS為服務(wù)器端GNS對DeleteTeleSeg命令的應(yīng)答AddSMGGNS為客戶端GNS通知SMG添加了一個SMGAddSMG_RespGNS為服務(wù)器端GNS對AddSMG命令的應(yīng)答ModifySMGGNS為客戶端GNS通知SMG修改了一個SMGModifySMG_RespGNS為服務(wù)器端GNS對ModifySMG命令的應(yīng)答DeleteSMGGNS為客戶端GNS通知SMG刪除了一個SMGDeleteSMG_RespGNS為服務(wù)器端GNS對DeleteSMG命令的應(yīng)答表3-8從GNS到SMG的消息
17
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版4消息定義
系統(tǒng)中的消息分三種:基于HTTP的消息、基于TCP/IP的消息和鑒權(quán)消息,系統(tǒng)中每個消息包最大不超過2K字節(jié)。
4.1基于通用HTTP的消息定義
HTTP客戶端采用POST方法向服務(wù)器端發(fā)送請求,服務(wù)器端返回應(yīng)答。HTTP請求和響應(yīng)的格式如下(請參照附錄三):格式===...說明HTTP協(xié)議頭和內(nèi)容之間必需有一個空行假使HTTP通信出錯(譬如所請求的URL不存在),則沒有內(nèi)容部分每個參數(shù)占一行,所有的參數(shù)名稱和參數(shù)值都為文本類型每行都要以回車/換行終止表4-1HTTP的消息格式
4.1.1Submit操作
在SP和SMG的通信中,SP用Submit命令向SMG提交MT短消息,SMG返回響應(yīng)。
Submit命令的請求內(nèi)容
參數(shù)名稱CommandId*SequenceNumberSPNumberChargeNumber說明命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字SP的接入號碼,字符付費(fèi)號碼,字符,手機(jī)號碼前加“86〞國別標(biāo)志;當(dāng)且僅當(dāng)群發(fā)且對用戶收費(fèi)時為空;假使為空,則該條短消息產(chǎn)生的費(fèi)用由UserNumber代表的用戶支付;假使為全零字符串“000000000000000000000〞,表示該條短消息產(chǎn)生的費(fèi)用由SP支付。一個或多個接收該短消息的手機(jī)號,手機(jī)號之間用逗號(,)隔開,字符,手機(jī)號碼前加“86〞國別標(biāo)志,如8613001125453,8613001132345企業(yè)代碼,取值范圍0-99999,字符業(yè)務(wù)代碼,由SP定義,字符計(jì)費(fèi)類型,字符UserNumberCorpIdServiceTypeFeeType*
18
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版FeeValueGivenValueAgentFlagMorelatetoMTFlagPriorityExpireTimeScheduleTimeReportFlagMessageTypeTP_pidTP_udhiMessageCodingMessageContentReserve*注1:消息ID定義在5.1中;*注2:計(jì)費(fèi)類型定義在5.3中。
取值范圍0-99999,該條短消息的收費(fèi)值,單位為分,由SP定義,字符對于包月制收費(fèi)的用戶,該值為月租費(fèi)的值取值范圍0-99999,贈送用戶的話費(fèi),單位為分,由SP定義,特指由SP向用戶發(fā)送廣告時的贈送話費(fèi),字符代收費(fèi)標(biāo)志,0:應(yīng)收;1:實(shí)收,字符引起MT消息的原因0-MO點(diǎn)播引起的第一條MT消息;1-MO點(diǎn)播引起的非第一條MT消息;2-非MO點(diǎn)播引起的MT消息;3-系統(tǒng)反饋引起的MT消息。字符優(yōu)先級0-9從低到高,默認(rèn)為0,十六進(jìn)制數(shù)字短消息壽命的終止時間,假使為空,表示使用短消息中心的缺省值。時間內(nèi)容為16個字符,格式為“yymmddhhmmsstnnp〞,其中“tnnp〞取固定值“032+〞,即默認(rèn)系統(tǒng)為北京時間短消息定時發(fā)送的時間,假使為空,表示立刻發(fā)送該短消息。時間內(nèi)容為16個字符,格式為“yymmddhhmmsstnnp〞,其中“tnnp〞取固定值“032+〞,即默認(rèn)系統(tǒng)為北京時間狀態(tài)報(bào)告標(biāo)記0-該條消息只有最終出錯時要返回狀態(tài)報(bào)告1-該條消息無論最終是否成功都要返回狀態(tài)報(bào)告2-該條消息不需要返回狀態(tài)報(bào)告3-該條消息僅攜帶包月計(jì)費(fèi)信息,不下發(fā)給用戶,要返回狀態(tài)報(bào)告其它-保存缺省設(shè)置為0,十六進(jìn)制數(shù)字信息類型:0-短消息信息其它:待定十六進(jìn)制數(shù)字GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的十六進(jìn)制數(shù)字GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的3,僅使用1位,右對齊十六進(jìn)制數(shù)字短消息的編碼格式。0:純ASCII字符串3:寫卡操作4:二進(jìn)制編碼8:UCS2編碼15:GBK編碼其它參見GSM3.38第4節(jié):SMSDataCodingScheme十六進(jìn)制數(shù)字短消息的內(nèi)容,十六進(jìn)制數(shù)字保存,擴(kuò)展用表4-2Submit命令的請求格式
Submit命令的應(yīng)答內(nèi)容
字段說明
19
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版CommandIdSequenceNumberResultReserve*注:錯誤碼定義在5.2中
命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字Submit命令是否成功接收。十六進(jìn)制數(shù)字0:接收成功其它:錯誤碼*保存,擴(kuò)展用表4-3Submit命令的應(yīng)答格式
4.1.2Deliver操作
在SP和SMG的通信中,SMG用Deliver命向SP發(fā)送一條MO短消息。SMG接收到Deliver命令,會返回Deliver_Resp應(yīng)答。SMG根據(jù)Deliver命令中目的特服號,判斷出該服務(wù)屬于和哪一個SMG相連接的SP,假使屬于本地SP,則直接發(fā)送到SP,否則路由至相應(yīng)的SMG。
Deliver命令的請求內(nèi)容
參數(shù)名稱CommandIdSequenceNumberUserNumberSPNumberTP_pidTP_udhi說明命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字發(fā)送該短消息的手機(jī)號,字符,手機(jī)號碼前加“86〞國別標(biāo)志接收該短消息的SP的接入號碼,字符GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的十六進(jìn)制數(shù)字GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的3,僅使用1位,右對齊十六進(jìn)制數(shù)字短消息的編碼格式。0:純ASCII字符串3:寫卡操作4:二進(jìn)制編碼8:UCS2編碼15:GBK編碼其它參見GSM3.38第4節(jié):SMSDataCodingScheme十六進(jìn)制數(shù)字短消息的內(nèi)容,十六進(jìn)制數(shù)字保存,擴(kuò)展用表4-4Deliver命令的請求格式
MessageCodingMessageContentReserveDeliver命令的應(yīng)答內(nèi)容
字段CommandIdSequenceNumber命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字說明
20
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版ResultReserveDeliver命令是否成功接收。十六進(jìn)制數(shù)字0:接收成功其它:錯誤碼保存,擴(kuò)展用表4-5Deliver命令的應(yīng)答格式
4.1.3Report操作
Report命令用于向SP發(fā)送一條從前的Submit命令的當(dāng)前狀態(tài)。
Report命令的請求內(nèi)容
參數(shù)名稱CommandIdSequenceNumberSubmitSequenceNumberReportType說明命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字該命令所涉及的Submit或deliver命令的序列號,十六進(jìn)制數(shù)字Report命令類型0:對從前一條Submit命令的狀態(tài)報(bào)告1:對從前一條前轉(zhuǎn)Deliver命令的狀態(tài)報(bào)告,十六進(jìn)制數(shù)字接收該短消息的手機(jī)號,字符,手機(jī)號碼前加“86〞國別標(biāo)志該命令所涉及的短消息的當(dāng)前執(zhí)行狀態(tài)0:發(fā)送成功1:等待發(fā)送2:發(fā)送失敗十六進(jìn)制數(shù)字當(dāng)State=2時為錯誤碼值,否則為0,十六進(jìn)制數(shù)字保存,擴(kuò)展用表4-6Report命令的請求格式
*注:當(dāng)report反饋的是短消息中心的狀態(tài)報(bào)告時,state的三種狀態(tài)與短消息狀態(tài)報(bào)告中的狀態(tài)的對應(yīng)關(guān)系見5.4report狀態(tài)與短消息狀態(tài)的映射。
UserNumberState*ErrorCodeReserveReport命令的應(yīng)答內(nèi)容
字段CommandIdSequenceNumberResult說明命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字Report命令是否成功接收。十六進(jìn)制數(shù)字0:接收成功其它:錯誤碼保存,擴(kuò)展用表4-7Report命令的應(yīng)答格式
Reserve
21
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版4.1.4UserRpt操作
UserRpt命令用于在完成對用戶鑒權(quán)后,由SMG向手機(jī)用戶所注冊的SP發(fā)送命令,對手機(jī)用戶進(jìn)行狀態(tài)配置。
UserRpt命令的請求內(nèi)容
參數(shù)名稱CommandIdSequenceNumberSPNumberUserNumberUserConditionReserve說明命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字SP的接入號碼,字符待配置的手機(jī)號碼,字符,手機(jī)號碼前加“86〞國別標(biāo)志十六進(jìn)制數(shù),0:注銷;1:欠費(fèi)停機(jī);2:恢復(fù)正常保存,擴(kuò)展用表4-8UserRpt命令的請求格式
UserRpt命令的應(yīng)答內(nèi)容
參數(shù)名稱CommandIdSequenceNumberResult命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字UserRpt命令執(zhí)行結(jié)果0:成功其它:錯誤碼保存,擴(kuò)展用表4-9UserRpt命令的應(yīng)答格式
說明Reserve4.1.5Trace操作
Trace命令用于向SMG請求跟蹤某一條MT短消息的狀態(tài)。
Trace命令的請求內(nèi)容
參數(shù)名稱CommandIdSequenceNumberSubmitSequenceNumberUserNumberReserve說明命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字被跟蹤MT短消息的命令序列號,十六進(jìn)制數(shù)字被跟蹤MT短消息的目的手機(jī)號,字符,手機(jī)號碼前加“86〞國別標(biāo)志保存,擴(kuò)展用表4-10Trace命令的請求格式
22
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版Trace命令的應(yīng)答內(nèi)容
字段CommandIdSequenceNumberCountResult說明命令I(lǐng)D,十六進(jìn)制數(shù)字序列號,十六進(jìn)制數(shù)字被跟蹤MT短消息經(jīng)過的節(jié)點(diǎn)個數(shù),當(dāng)被跟蹤短消息經(jīng)過多個節(jié)點(diǎn)時,以下各個字段可重復(fù)Trace命令在該節(jié)點(diǎn)是否成功接收。十六進(jìn)制數(shù)字0:接收成功1:等待處理其它:錯誤碼節(jié)點(diǎn)編號,字符被跟蹤的短消息到達(dá)該節(jié)點(diǎn)時刻,格式為“yymmddhhmmss〞該節(jié)點(diǎn)發(fā)出被跟蹤的短消息時刻,格式為“yymmddhhmmss〞保存,擴(kuò)展用,當(dāng)被跟蹤短消息經(jīng)過多個節(jié)點(diǎn)時,以上各個字段可重復(fù)表4-11Trace命令的應(yīng)答格式
NodeIdReceiveTimeSendTimeReserve4.2基于專用SGIP的消息定義
專用SGIP協(xié)議中定義的消息由消息頭和消息體組成。項(xiàng)目消息頭消息體消息頭部分消息體部分表4-12消息的組成
說明4.2.1數(shù)據(jù)類型
消息中利用到如下數(shù)據(jù)類型
類型IntegerText說明無符號整數(shù)定長字符串,左對齊存儲,空余位置補(bǔ)’\\0’表4-13消息的數(shù)據(jù)類型
消息中的所有Integer類型的字段均采用網(wǎng)絡(luò)字節(jié)順序。所有消息中的序列號字段均占12個字節(jié),分為3個4字節(jié)整數(shù);通信傳輸時每個整數(shù)都使用網(wǎng)絡(luò)字節(jié)順序,但整數(shù)的次序并不改變。也就是說,通信傳輸?shù)臅r候,序列號字段應(yīng)當(dāng)依照三個連續(xù)的4字節(jié)整數(shù)來處理。
23
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版4.2.2消息頭的格式
字段MessageLengthCommandIDSequenceNumber長度(字節(jié))4412類型IntegerIntegerInteger說明消息的總長度(字節(jié))命令I(lǐng)D序列號表4-14消息頭的格式
4.2.3消息體的格式
Bind操作
Bind操作由Bind命令和Bind_Resp應(yīng)答組成??蛻舳耸紫劝l(fā)送Bind命令,服務(wù)器端收到Bind命令后,對命令發(fā)送方進(jìn)行驗(yàn)證,然后返回Bind_Resp應(yīng)答。
.1Bind命令的語法
字段LoginType長度(字節(jié))1類型Integer說明登錄類型。1:SP向SMG建立的連接,用于發(fā)送命令2:SMG向SP建立的連接,用于發(fā)送命令3:SMG之間建立的連接,用于轉(zhuǎn)發(fā)命令4:SMG向GNS建立的連接,用于路由表的檢索和維護(hù)5:GNS向SMG建立的連接,用于路由表的更新6:主備GNS之間建立的連接,用于主備路由表的一致性11:SP與SMG以及SMG之間建立的測試連接,用于跟蹤測試其它:保存服務(wù)器端給客戶端分派的登錄名服務(wù)器端和LoginName對應(yīng)的密碼保存,擴(kuò)展用LoginNameLoginPassowrdReserve16168TextTextText表4-15Bind消息格式
.2Bind_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明Bind執(zhí)行命令是否成功。0:執(zhí)行成功其它:錯誤碼
24
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版Reserve8Text保存,擴(kuò)展用表4-16Bind_Resp消息格式
Unbind操作
Unbind操作由Unbind命令和Unbind_Resp應(yīng)答組成。通信連接建立以后,客戶端假使要中止通信,需要發(fā)送Unbind命令;服務(wù)器端收到Unbind命令后,向客戶端發(fā)送Unbind_Resp相應(yīng),然后雙方斷開連接。
.1Unbind命令的語法
Unbind命令沒有消息體。
.2Unbind_Resp應(yīng)答的語法
Unbind_Resp應(yīng)答沒有消息體。
Submit操作
在SP和SMG的通信中,SP用Submit命令向SMG提交MT短消息,發(fā)送到用戶的手機(jī)中。SMG接收到Submit命令,會返回Submit_Resp應(yīng)答。SMG根據(jù)Submit命令中的付費(fèi)號碼,判斷出該命令是否應(yīng)從本地SMSC發(fā)送,假使屬于本地發(fā)送,則直接發(fā)送到相應(yīng)的SMSC,否則路由至相應(yīng)的SMG。
在SMG和SMG的通信中,Submit命令用于SMG客戶端向服務(wù)器端路由從SP收到的MT短消息。服務(wù)器端接收到Submit命令后,再發(fā)送到與之相連的目的SMSC。
.1Submit命令的語法
字段SPNumberChargeNumber長度(字節(jié))2121類型TextText說明SP的接入號碼付費(fèi)號碼,手機(jī)號碼前加“86〞國別標(biāo)志;當(dāng)且僅當(dāng)群發(fā)且對用戶收費(fèi)時為空;假使為空,則該條短消息產(chǎn)生的費(fèi)用由UserNumber代表的用戶支付;假使為全零字符串“000000000000000000000〞,表示該條短消息產(chǎn)生的費(fèi)用由SP支付。接收短消息的手機(jī)數(shù)量,取值范圍1至100UserCount1Integer
25
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版UserNumber…CorpIdServiceTypeFeeTypeFeeValue21…51016Text…TextTextIntegerTextGivenValue6TextAgentFlagMorelatetoMTFlag11IntegerIntegerPriorityExpireTime116IntegerText接收該短消息的手機(jī)號,該字段重復(fù)UserCount指定的次數(shù),手機(jī)號碼前加“86〞國別標(biāo)志…企業(yè)代碼,取值范圍0-99999業(yè)務(wù)代碼,由SP定義計(jì)費(fèi)類型取值范圍0-99999,該條短消息的收費(fèi)值,單位為分,由SP定義對于包月制收費(fèi)的用戶,該值為月租費(fèi)的值取值范圍0-99999,贈送用戶的話費(fèi),單位為分,由SP定義,特指由SP向用戶發(fā)送廣告時的贈送話費(fèi)代收費(fèi)標(biāo)志,0:應(yīng)收;1:實(shí)收引起MT消息的原因0-MO點(diǎn)播引起的第一條MT消息;1-MO點(diǎn)播引起的非第一條MT消息;2-非MO點(diǎn)播引起的MT消息;3-系統(tǒng)反饋引起的MT消息。優(yōu)先級0-9從低到高,默認(rèn)為0短消息壽命的終止時間,假使為空,表示使用短消息中心的缺省值。時間內(nèi)容為16個字符,格式為〞yymmddhhmmsstnnp〞,其中“tnnp〞取固定值“032+〞,即默認(rèn)系統(tǒng)為北京時間短消息定時發(fā)送的時間,假使為空,表示立刻發(fā)送該短消息。時間內(nèi)容為16個字符,格式為“yymmddhhmmsstnnp〞,其中“tnnp〞取固定值“032+〞,即默認(rèn)系統(tǒng)為北京時間狀態(tài)報(bào)告標(biāo)記0-該條消息只有最終出錯時要返回狀態(tài)報(bào)告1-該條消息無論最終是否成功都要返回狀態(tài)報(bào)告2-該條消息不需要返回狀態(tài)報(bào)告3-該條消息僅攜帶包月計(jì)費(fèi)信息,不下發(fā)給用戶,要返回狀態(tài)報(bào)告其它-保存缺省設(shè)置為0GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的3,僅使用1位,右對齊短消息的編碼格式。0:純ASCII字符串3:寫卡操作4:二進(jìn)制編碼8:UCS2編碼15:GBK編碼其它參見GSM3.38第4節(jié):SMSDataCodingScheme信息類型:0-短消息信息其它:待定短消息的長度短消息的內(nèi)容保存,擴(kuò)展用ScheduleTime16TextReportFlag1IntegerTP_pidTP_udhiMessageCoding111IntegerIntegerIntegerMessageType1IntegerMessageLengthMessageContentReserve4MessageLength8IntegerTextText表4-17Submit消息格式
26
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版.2Submit_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明Submit命令是否成功接收。0:接收成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-18Submit_Resp消息格式
Deliver操作
在SP和SMG的通信中,SMG用Deliver命令向SP發(fā)送一條MO短消息。SP接收到Deliver命令,會返回Deliver_Resp應(yīng)答。SMG根據(jù)Deliver命令中目的特服號,判斷出該服務(wù)屬于和哪一個SMG相連接的SP,假使屬于本地SP,則直接發(fā)送到SP,否則路由至相應(yīng)的SMG。
在SMG和SMG的通信中,Deliver命令用于SMG客戶端向服務(wù)器端路由MO短消息。服務(wù)器端接收到Deliver命令后,再發(fā)送到與之相連的目的SP。
.1Deliver命令的語法
字段UserNumberSPNumberTP_pidTP_udhiMessageCoding長度(字節(jié))2121111類型TextTextIntegerIntegerInteger說明發(fā)送短消息的用戶手機(jī)號,手機(jī)號碼前加“86〞國別標(biāo)志SP的接入號碼GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的3,僅使用1位,右對齊短消息的編碼格式。0:純ASCII字符串3:寫卡操作4:二進(jìn)制編碼8:UCS2編碼15:GBK編碼其它參見GSM3.38第4節(jié):SMSDataCodingScheme短消息的長度短消息的內(nèi)容保存,擴(kuò)展用MessageLengthMessageContentReserve4MessageLength8IntegerTextText表4-19Deliver消息格式
.2Deliver_Resp應(yīng)答的語法
字段長度(字節(jié))類型說明
27
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版Result1IntegerReserve8TextDeliver命令是否成功接收。0:接收成功其它:錯誤碼保存,擴(kuò)展用表4-20Del.iver_Resp消息格式
Report操作
Report命令用于向SP發(fā)送一條從前的Submit命令的當(dāng)前狀態(tài),或者用于向前轉(zhuǎn)SMG發(fā)送一條從前的Deliver命令的當(dāng)前狀態(tài)。Report命令的接收方需要向發(fā)送方返回Report_Resp命令。
.1Report命令的語法
字段SubmitSequenceNumberReportType長度(字節(jié))121類型IntegerInteger說明該命令所涉及的Submit或deliver命令的序列號Report命令類型0:對從前一條Submit命令的狀態(tài)報(bào)告1:對從前一條前轉(zhuǎn)Deliver命令的狀態(tài)報(bào)告接收短消息的手機(jī)號,手機(jī)號碼前加“86〞國別標(biāo)志該命令所涉及的短消息的當(dāng)前執(zhí)行狀態(tài)0:發(fā)送成功1:等待發(fā)送2:發(fā)送失敗當(dāng)State=2時為錯誤碼值,否則為0保存,擴(kuò)展用UserNumberState211TextIntegerErrorCodeReserve18IntegerText表4-21Report消息格式
.2Report_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明Report命令是否成功接收。0:接收成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-22Report_Resp消息格式
AddSP操作
AddSP操作用于在SMG和GNS之間通知添加了一個SP。
28
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版.1AddSP命令的語法
字段SMGIdSPNumberServiceTagCorpIdReserve長度(字節(jié))6211058類型TextTextTextTextText說明SP所在SMG的節(jié)點(diǎn)編號SP的接入號碼業(yè)務(wù)代碼,該字段為空時不考慮服務(wù)特征串企業(yè)代碼,取值范圍0-99999保存,擴(kuò)展用表4-23AddSP消息格式
.2AddSP_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明AddSP命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-24AddSP_Resp消息格式
ModifySP操作
ModifySP操作用于在SMG和GNS之間通知修改了一個SP的接入號碼。
.1ModifySP命令的語法
字段SMGIdOldSPNumberOldServiceTagNewSPNumberNewServiceTagCorpIdReserve長度(字節(jié))62110211058類型TextTextTextTextTextTextText說明SP所在SMG的節(jié)點(diǎn)編號SP的原接入號碼業(yè)務(wù)代碼,該字段為空時不考慮服務(wù)特征串SP的新接入號碼業(yè)務(wù)代碼,該字段為空時不考慮服務(wù)特征串SP新的企業(yè)代碼,可以不變保存,擴(kuò)展用表4-25ModifySP消息格式
.2ModifySP_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明ModifySP命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-26ModifySP_Resp消息格式
29
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版DeleteSP操作
DeleteSP操作用于在SMG和GNS之間通知刪除了一個SP的接入號碼。
.1DeleteSP命令的語法
字段SMGIdSPNumberServiceTagReserve長度(字節(jié))621108類型TextTextTextText說明SP所在SMG的節(jié)點(diǎn)編號SP的接入號碼業(yè)務(wù)代碼,該字段為空時不考慮服務(wù)特征串保存,擴(kuò)展用表4-27DeleteSP消息格式
.2DeleteSP_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明DeleteSP命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-28DeleteSP_Resp消息格式
QueryRoute操作
QueryRoute操作用于在SMG向GNS請求一條或全部路由信息。
.1QueryRoute命令的語法
字段QueryType長度(字節(jié))1類型Integer說明請求類型0-全部路由表信息1-根據(jù)SP接入號碼查找SMG2-根據(jù)手機(jī)號碼段查找SMG3-根據(jù)SP接入號碼和業(yè)務(wù)代碼查找SMG4-根據(jù)SMG節(jié)點(diǎn)編號查找該SMG所對應(yīng)全部路由信息請求類型為0-忽略1和3-SP接入號碼2-手機(jī)號碼段4-SMG節(jié)點(diǎn)編號左對齊,剩余部分填’\\0’業(yè)務(wù)代碼,該字段為空時不考慮業(yè)務(wù)代碼,請求類型為0、1、2時,該字段無效。Number21TextServiceTag10Text
30
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版Reserve8Text保存,擴(kuò)展用表4-29QueryRoute消息格式
.2QueryRoute_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明QueryRoute命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼返回路由表項(xiàng)的個數(shù)(>=1),假使大于1,則以下字段(包括Reserve字段)重復(fù)出現(xiàn)表項(xiàng)類型1-Number為SP接入號碼2-Number為手機(jī)號碼段SP接入號碼或手機(jī)號碼段SP業(yè)務(wù)代碼或手機(jī)用戶類型當(dāng)Type為1時,可表示SP業(yè)務(wù)代碼,該字段為空則不考慮業(yè)務(wù)代碼;當(dāng)Type為2時,表示手機(jī)用戶類型;SP企業(yè)代碼或號段所在地區(qū)長途區(qū)號左對齊,剩余部分填’\\0’SMG節(jié)點(diǎn)編號SMGIP地址號SMG的登錄用戶名SMG的登錄密碼保存,擴(kuò)展用CountType41IntegerIntegerNumberMark2110TextTextCodeSMGIdSMGIPLoginUserPasswordReserve56416168TextTextIntegerTextTextText表4-30QueryRoute_Resp消息格式
還有待完善
QueryRoute_Resp每次最多返回20條路由信息,當(dāng)全部路由信息超過20條時,GNS對路由信息分包傳送,并在傳送完所有路由信息后發(fā)送一個空包(包體為空)說明應(yīng)答終止。
0AddTeleSeg操作
AddTeleSeg操作用于在GNS向SMG通知添加了一個號碼段。
0.1AddTeleSeg命令的語法
字段SMGIdTeleSegTeleTypeAreaCodeReserve長度(字節(jié))67148類型TextTextTextTextText說明號碼段所在SMG的節(jié)點(diǎn)編號手機(jī)號碼段用戶類型;0:簽約用戶,1:如意通號段所在地區(qū)長途區(qū)號保存,擴(kuò)展用表4-31AddTeleSeg消息格式
31
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版0.2AddTeleSeg_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明AddTeleSeg命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-32AddTeleSeg_Resp消息格式
1ModifyTeleSeg操作
ModifyTeleSeg操作用于在GNS向SMG通知修改了一個號碼段。
1.1ModifyTeleSeg命令的語法
字段SMGIdOldTeleSegNewTeleSegNewTeleTypeNewAreaCodeReserve長度(字節(jié))677148類型TextTextTextTextTextText說明號碼段所在SMG的節(jié)點(diǎn)編號原號碼段新號碼段新號段用戶類型;0:簽約用戶,1:如意通新號段所在地區(qū)長途區(qū)號,可以不變保存,擴(kuò)展用表4-33ModifyTeleSeg消息格式
1.2ModifyTeleSeg_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明ModifyTeleSeg命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-34ModifyTeleSeg_Resp消息格式
2DeleteTeleSeg操作
DeleteTeleSeg操作用于在GNS通知SMG刪除了一個號碼段。
2.1DeleteTeleSeg命令的語法
字段長度(字節(jié))類型說明
32
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版SMGIdTeleSegReserve678TextTextText號碼段所在SMG的節(jié)點(diǎn)編號號碼段保存,擴(kuò)展用表4-35DeleteTeleSeg消息格式
2.2DeleteTeleSeg_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明DeleteTeleSeg命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-37DeleteTeleSeg_Resp消息格式
3AddSMG操作
3.1AddSMG命令的語法
字段SMGIdSMGIPLoginNameLoginPassowrdReserve長度(字節(jié))6416168類型TextIntegerTextTextText說明新增SMG的節(jié)點(diǎn)編號SMGIP地址號服務(wù)器端為SMG分派的登錄名服務(wù)器端和LoginName對應(yīng)的密碼保存,擴(kuò)展用表4-38AddSMG消息格式
3.2AddSMG_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明AddSMG命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-39AddSMG_Resp消息格式
33
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議1.1版4ModifySMG操作
4.1ModifySMG命令的語法
字段OldSMGIdNewSMGIdSMGIPLoginNameLoginPassowrdReserve長度(字節(jié))66416168類型TextTextIntegerTextTextText說明被修改的SMG的原節(jié)點(diǎn)編號被修改的SMG的新節(jié)點(diǎn)編號SMG新的IP地址號服務(wù)器端為SMG分派的登錄名服務(wù)器端和LoginName對應(yīng)的密碼保存,擴(kuò)展用表4-40ModifySMG消息格式
4.2ModifySMG_Resp應(yīng)答的語法
字段Result長度(字節(jié))1類型Integer說明ModifySMG命令是否成功執(zhí)行。0:執(zhí)行成功其它:錯誤碼保存,擴(kuò)展用Reserve8Text表4-41ModifySMG_Resp消息格式
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
- 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 2025至2030年中國大豆專用腐植酸復(fù)合肥數(shù)據(jù)監(jiān)測研究報(bào)告
- 2025至2030年中國圣誕燈串?dāng)?shù)據(jù)監(jiān)測研究報(bào)告
- 2025至2030年中國內(nèi)花紋牽伸膠圈數(shù)據(jù)監(jiān)測研究報(bào)告
- 2025至2030年中國二軸電腦彈簧機(jī)數(shù)據(jù)監(jiān)測研究報(bào)告
- 2025年中國超聲波粉位測量儀市場調(diào)查研究報(bào)告
- 2025年中國網(wǎng)上客戶關(guān)系管理系統(tǒng)市場調(diào)查研究報(bào)告
- 2025年中國水潤滑艉軸密封裝置市場調(diào)查研究報(bào)告
- 2025年中國有色金屬球市場調(diào)查研究報(bào)告
- 2025年中國平頭無帽沿發(fā)光二極管市場調(diào)查研究報(bào)告
- 2025年中國圣誕老人提手四方籃市場調(diào)查研究報(bào)告
- 中山大學(xué)抬頭信紙中山大學(xué)橫式便箋紙推薦信模板a
- 無形資產(chǎn)評估完整版課件
- 義務(wù)教育學(xué)科作業(yè)設(shè)計(jì)與管理指南
- 《汽車發(fā)展史》PPT課件(PPT 75頁)
- 常暗之廂(7規(guī)則-簡體修正)
- 反詐騙防詐騙主題教育宣傳圖文PPT教學(xué)課件
- 制冷系統(tǒng)方案的設(shè)計(jì)pptx課件
- 修心七要原文
- 納期管理流程圖
- 中國TBHQ行業(yè)市場調(diào)研報(bào)告
- 1資產(chǎn)負(fù)債表變動情況的分析評價
評論
0/150
提交評論