中國(guó)電信SMGP協(xié)議_第1頁(yè)
中國(guó)電信SMGP協(xié)議_第2頁(yè)
中國(guó)電信SMGP協(xié)議_第3頁(yè)
中國(guó)電信SMGP協(xié)議_第4頁(yè)
中國(guó)電信SMGP協(xié)議_第5頁(yè)
已閱讀5頁(yè),還剩124頁(yè)未讀, 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說(shuō)明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡(jiǎn)介

中國(guó)電信SMGP協(xié)議綜合業(yè)務(wù)管理平臺(tái)ISMP設(shè)備規(guī)范SNR2ISMPV2.1.0文檔編號(hào):000001綜合業(yè)務(wù)管理平臺(tái)ISMP設(shè)備規(guī)范SNR2ISMPV2.1.0文檔編號(hào):000001PAGE11-中國(guó)電信集團(tuán)公司2008-03實(shí)施2008-03發(fā)布中國(guó)電信中國(guó)電信集團(tuán)公司2008-03實(shí)施2008-03發(fā)布中國(guó)電信短消息網(wǎng)關(guān)協(xié)議(SMGP)CT/TSNRC1SMGPV3.0.2CT中國(guó)電信企業(yè)標(biāo)準(zhǔn)短消息網(wǎng)關(guān)協(xié)議SNRC1SMGPV3.0.目錄TOC\o"1-2"\h\z1 適用范圍 22 引用標(biāo)準(zhǔn) 33 縮略語(yǔ) 44 SMGP協(xié)議概述 54.1 定義 54.2 通信方式 54.3 協(xié)議應(yīng)用及涉及的端口號(hào) 75 SMGP協(xié)議 105.1 數(shù)據(jù)類型 105.2 消息結(jié)構(gòu) 106 參數(shù)定義 256.1 消息頭參數(shù)描述 256.2 消息體必選參數(shù)描述 276.3 消息體可選參數(shù)描述 427 基于SMGP協(xié)議的API函數(shù) 48附錄A基于SMGP協(xié)議的API函數(shù)說(shuō)明(規(guī)范性附錄) 49A.1基本要求 49A.2API數(shù)據(jù)結(jié)構(gòu)說(shuō)明(以C語(yǔ)言為例) 50A.3API函數(shù)說(shuō)明 52A.4配置SMGPAPI 56A.5短消息的自動(dòng)分割功能 57A.6錯(cuò)誤代碼含義 57附錄B短消息群發(fā)功能的實(shí)現(xiàn)(資料性附錄) 60附錄C修改歷史記錄 60短消息網(wǎng)關(guān)協(xié)議SNRC1SMGPV3.0. -PAGE1-前言本標(biāo)準(zhǔn)規(guī)定了短消息網(wǎng)關(guān)與其它網(wǎng)元之間進(jìn)行短消息傳輸?shù)慕涌趨f(xié)議。本標(biāo)準(zhǔn)是在SMGP協(xié)議V2.0的基礎(chǔ)上,基于3G網(wǎng)絡(luò)的短消息業(yè)務(wù)發(fā)展需求進(jìn)行修訂而成。本標(biāo)準(zhǔn)共包含3部分:1、SMGP基本協(xié)議;2、SMGP協(xié)議擴(kuò)展計(jì)費(fèi)接口;3、SMGP協(xié)議擴(kuò)展電子商務(wù)接口。本文只描述了第1部分SMGP基本協(xié)議,第2部分和第3部分同SMGP協(xié)議V2.0。本標(biāo)準(zhǔn)起草單位:中國(guó)電信股份有限公司、中國(guó)電信股份有限公司上海研究院本標(biāo)準(zhǔn)主要起草人:葛敏周文君顧麗麗蔣力董斌施唯佳顧震宇 -PAGE58-適用范圍本協(xié)議適用于短消息網(wǎng)絡(luò)上(固定網(wǎng)、移動(dòng)網(wǎng))短消息網(wǎng)關(guān)與其它網(wǎng)元之間進(jìn)行短消息的傳輸。本協(xié)議適用于短消息網(wǎng)關(guān)、相關(guān)網(wǎng)元設(shè)備開發(fā)商及內(nèi)容提供商。

引用標(biāo)準(zhǔn)下列文件通過(guò)本文的參考而成為本規(guī)范的條款。凡是注日期的參考文件,其隨后所有的修改單(不包括勘誤的內(nèi)容)或修訂版均不適用于本文,凡是不注日期的參考文件,其最新版本適用于本文?!?】ShortMessagePeertoPeerProtocolSpecification【2】中國(guó)電信CDMA短消息網(wǎng)關(guān)設(shè)備規(guī)范v1.0【3】中國(guó)電信CDMA短消息網(wǎng)關(guān)測(cè)試規(guī)范v1.0【4】中國(guó)電信綜合業(yè)務(wù)管理平臺(tái)ISMP接口規(guī)范V1.0.0縮略語(yǔ)縮略語(yǔ)英文全名中文全名ESMEExternalShortMessageEntity外部短消息實(shí)體GNSGatewayNameServer匯接網(wǎng)關(guān)SPServiceProvider服務(wù)提供商SMSCShort短消息業(yè)務(wù)中心SMGPShortMessageGatewayProtocol短消息網(wǎng)關(guān)協(xié)議SMGWShortMessageGateway短消息網(wǎng)關(guān)SMPPShortMessagePointtoPointProtocol短消息點(diǎn)到點(diǎn)協(xié)議

SMGP協(xié)議概述定義SMGP協(xié)議是SMGW與其它網(wǎng)元設(shè)備(除SMC外)進(jìn)行短消息傳輸?shù)慕涌趨f(xié)議。非SMC網(wǎng)元設(shè)備向SMGW發(fā)送或從SMGW接收短消息,這些非SMC網(wǎng)元設(shè)備稱為ESME。通信方式SMGW與ESME之間共有兩種連接方式:長(zhǎng)連接和短連接。所謂長(zhǎng)連接,指在一個(gè)TCP連接上可以連續(xù)發(fā)送多個(gè)數(shù)據(jù)包,在TCP連接保持期間,如果沒有數(shù)據(jù)包發(fā)送,需要雙方發(fā)鏈路檢測(cè)包以維持此連接。短連接是指通信雙方有數(shù)據(jù)交互時(shí),就建立一個(gè)TCP連接,數(shù)據(jù)發(fā)送完成后,則斷開此TCP連接,即每次TCP連接只完成一對(duì)SMGP消息的發(fā)送。長(zhǎng)連接通信雙方以客戶-服務(wù)器方式建立TCP連接,用于雙方信息的相互提交。當(dāng)信道上沒有數(shù)據(jù)傳輸時(shí),通信雙方應(yīng)每隔時(shí)間C發(fā)送鏈路檢測(cè)包以維持此連接,當(dāng)鏈路檢測(cè)包發(fā)出超過(guò)時(shí)間T后未收到響應(yīng),應(yīng)立即再發(fā)送鏈路檢測(cè)包,再連續(xù)發(fā)送N-1次后仍未得到響應(yīng)則斷開此連接。參數(shù)C、T、N原則上應(yīng)可配置,現(xiàn)階段建議取值為:C=3分鐘,T=60秒,N=3。通信雙方之間的消息如果不能成功發(fā)送,應(yīng)隔時(shí)間R進(jìn)行重發(fā),再連續(xù)發(fā)送N-1次后仍未發(fā)送成功則停發(fā)?,F(xiàn)階段建議取值為:R=60秒,N=3。通信雙方之間的消息發(fā)送后等待T秒后未收到響應(yīng),應(yīng)立即重發(fā),再連續(xù)發(fā)送N-1次后仍未得到響應(yīng)則停發(fā)?,F(xiàn)階段建議取值為:T=60秒,N=3。消息采用并發(fā)方式發(fā)送,加以滑動(dòng)窗口流量控制,窗口大小參數(shù)W可配置,現(xiàn)階段建議為16,即接收方在應(yīng)答前一次收到的消息最多不超過(guò)16條。長(zhǎng)連接的操作流程舉例如圖1所示:......滑動(dòng)窗口不大于W WSMGP消息1客戶端服務(wù)器端SMGP消息2對(duì)SMGP消息1的響應(yīng)對(duì)SMGP消息2的響應(yīng)鏈路檢測(cè)包鏈路檢測(cè)包響應(yīng)建立TCP連接鏈路檢測(cè)包鏈路檢測(cè)包響應(yīng)拆除TCP連接......圖4.1長(zhǎng)連接操作流程

短連接通信雙方以客戶-服務(wù)器方式建立TCP連接,應(yīng)答與請(qǐng)求在同一個(gè)連接中完成。系統(tǒng)采用客戶/服務(wù)器模式,操作以客戶端驅(qū)動(dòng)方式發(fā)起連接請(qǐng)求,完成一次操作后關(guān)閉此連接。通信雙方之間的消息發(fā)送后等待T秒后未收到響應(yīng),應(yīng)立即重發(fā),再連續(xù)發(fā)送N-1次后仍未得到響應(yīng)則停發(fā)?,F(xiàn)階段建議取值為:T=60秒,N=3。短連接的操作流程舉例如圖2所示:對(duì)SMGP消息1的響應(yīng)SMGP消息1對(duì)SMGP消息1的響應(yīng)SMGP消息1建立TCP連接拆除TCP連接SMGP消息2對(duì)SMGP消息2的響應(yīng)建立TCP連接拆除TCP連接......客戶端服務(wù)器端圖4.2短連接操作流程協(xié)議應(yīng)用及涉及的端口號(hào)SMGP協(xié)議在中國(guó)電信中的應(yīng)用主要體現(xiàn)在兩類短消息業(yè)務(wù)上:一類是固定網(wǎng)短消息業(yè)務(wù),另一類是移動(dòng)網(wǎng)短消息業(yè)務(wù)。固定網(wǎng)短消息業(yè)務(wù)圖4.3固定網(wǎng)短消息業(yè)務(wù)系統(tǒng)結(jié)構(gòu)簡(jiǎn)圖固定網(wǎng)短消息業(yè)務(wù)系統(tǒng)結(jié)構(gòu)簡(jiǎn)圖如圖3所示。SMGP協(xié)議在固網(wǎng)短消息系統(tǒng)中應(yīng)用情況如下:二級(jí)SMGW與SP二級(jí)SMGW與SP之間采用SMGP協(xié)議進(jìn)行短消息的傳輸,端口號(hào)為8890,二級(jí)SMGW為服務(wù)器端,SP為客戶端;二級(jí)SMGW與一級(jí)SMGW二級(jí)SMGW與一級(jí)SMGW之間采用SMGP協(xié)議進(jìn)行短消息的傳輸,端口號(hào)為8900,二級(jí)SMGW與一級(jí)SMGW互為客戶/服務(wù)器端;二級(jí)SMGW與一級(jí)SMGW之間采用SMGP協(xié)議擴(kuò)展計(jì)費(fèi)接口(參見SMGPV2.0)進(jìn)行計(jì)費(fèi)信息的傳輸,端口號(hào)為8900,二級(jí)SMGW作為服務(wù)器端,一級(jí)SMGW作為客戶端;一級(jí)SMGW與SP一級(jí)SMGW與SP之間采用SMGP協(xié)議進(jìn)行短消息的傳輸,端口號(hào)為8890,一級(jí)SMGW為服務(wù)器端,SP為客戶端;二級(jí)SMGW和PHS預(yù)付費(fèi)平臺(tái)二級(jí)SMGW與PHS預(yù)付費(fèi)平臺(tái)之間采用SMGP協(xié)議擴(kuò)展計(jì)費(fèi)接口(參見SMGPV2.0)進(jìn)行計(jì)費(fèi)信息的傳輸,端口號(hào)為9100,預(yù)付費(fèi)平臺(tái)作為服務(wù)器端,二級(jí)SMGW作為客戶端。移動(dòng)網(wǎng)短消息業(yè)務(wù)GNSGNSSMGWSMGWSMCSMC圖4.4移動(dòng)網(wǎng)短消息業(yè)務(wù)系統(tǒng)結(jié)構(gòu)簡(jiǎn)圖構(gòu)圖SMGPSMGPSPSPSMGPSMGPSMGP移動(dòng)網(wǎng)移動(dòng)網(wǎng)移動(dòng)網(wǎng)終端移動(dòng)網(wǎng)終端移動(dòng)網(wǎng)短消息業(yè)務(wù)系統(tǒng)結(jié)構(gòu)簡(jiǎn)圖如圖4所示。SMGP協(xié)議在移動(dòng)網(wǎng)短消息系統(tǒng)中應(yīng)用情況如下:SMGW與SPSMGW與SP之間采用SMGP協(xié)議進(jìn)行短消息的傳輸,端口號(hào)為8890,SMGW為服務(wù)器端,SP為客戶端;SMGW與SMGWSMGW與SMGW之間采用SMGP協(xié)議進(jìn)行短消息的傳輸,端口號(hào)為8900,SMGW與SMGW互為客戶/服務(wù)器端;SMGW與GNSSMGW與GNS之間采用SMGP協(xié)議進(jìn)行消息傳輸,端口號(hào)為8901,SMGW為服務(wù)器端,GNS為客戶端。SMGP協(xié)議數(shù)據(jù)類型基本數(shù)據(jù)類型Integer無(wú)符號(hào)整數(shù)OctetString不強(qiáng)制以0x00結(jié)尾的定長(zhǎng)字符串。當(dāng)位數(shù)不足時(shí),在不明確注明的情況下,應(yīng)左對(duì)齊,右補(bǔ)0x00。在明確注明的情況下,以該字段的明確注明為準(zhǔn)??蛇x參數(shù)可選參數(shù)采用TLV(Tag、Length、Value)形式定義,每個(gè)可選參數(shù)的Tag、Length、Value的定義見6.3節(jié)。字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2Integer字段的標(biāo)簽,用于唯一標(biāo)識(shí)可選參數(shù)Length2Integer字段的長(zhǎng)度Value可變長(zhǎng)度可變類型字段內(nèi)容消息結(jié)構(gòu)項(xiàng)目說(shuō)明MessageHeader消息頭(所有消息公共包頭)MessageBody消息體消息頭結(jié)構(gòu)字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考PacketLength4Integer數(shù)據(jù)包長(zhǎng)度6.1.1RequestID4Integer請(qǐng)求標(biāo)識(shí)6.1.2SequenceID4Integer消息流水號(hào)6.1.3消息體結(jié)構(gòu)登錄操作(Login)Login操作的目的是客戶端向服務(wù)器端注冊(cè)作為一個(gè)合法客戶端身份,若注冊(cè)成功后即建立了應(yīng)用層的連接,此后客戶端可以與此服務(wù)器端進(jìn)行消息的接收和發(fā)送。服務(wù)器端以Login_Resp消息響應(yīng)客戶端的請(qǐng)求。Login字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)ClientID8OctetString客戶端用來(lái)登錄服務(wù)器端的用戶賬號(hào)。6.2.1AuthenticatorClient16OctetString客戶端認(rèn)證碼,用來(lái)鑒別客戶端的合法性。6.2.2LoginMode1Integer客戶端用來(lái)登錄服務(wù)器端的登錄類型。6.2.3TimeStamp4Integer時(shí)間戳6.2.4ClientVersion1Integer客戶端支持的協(xié)議版本號(hào)6.2.5Login_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6AuthenticatorServer16OctetString服務(wù)器端返回給客戶端的認(rèn)證碼6.2.7ServerVersion1Integer服務(wù)器端支持的最高版本號(hào)6.2.8SP向SMGW提交短消息的操作(Submit)Submit字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)MsgType1Integer短消息類型6.2.9NeedReport1IntegerSP是否要求返回狀態(tài)報(bào)告6.2.10Priority1Integer短消息發(fā)送優(yōu)先級(jí)6.2.11ServiceID10OctetString業(yè)務(wù)代碼6.2.12FeeType2OctetString收費(fèi)類型6.2.13FeeCode6OctetString資費(fèi)代碼6.2.14FixedFee6OctetString包月費(fèi)/封頂費(fèi)6.2.15MsgFormat1Integer短消息格式6.2.16ValidTime17OctetString短消息有效時(shí)間6.2.17AtTime17OctetString短消息定時(shí)發(fā)送時(shí)間6.2.18SrcTermID21OctetString短信息發(fā)送方號(hào)碼6.2.19ChargeTermID21OctetString計(jì)費(fèi)用戶號(hào)碼6.2.20DestTermIDCount1Integer短消息接收號(hào)碼總數(shù)6.2.21DestTermID21*DestTermCountOctetString*短消息接收號(hào)碼6.2.22MsgLength1Integer短消息長(zhǎng)度6.2.23MsgContentMsgLengthOctetString短消息內(nèi)容6.2.24Reserve8OctetString保留6.2.25可選參數(shù)字段數(shù)據(jù)類型說(shuō)明參考TP_pidTLVGSM協(xié)議類型6.3.2TP_udhiTLVGSM協(xié)議類型6.3.3LinkIDTLV交易標(biāo)識(shí)6.3.4MsgSrcTLV信息內(nèi)容的來(lái)源6.3.17ChargeUserTypeTLV計(jì)費(fèi)用戶類型6.3.5ChargeTermTypeTLV計(jì)費(fèi)用戶的號(hào)碼類型6.3.6ChargeTermPseudoTLV計(jì)費(fèi)用戶的偽碼6.3.7DestTermTypeTLV短消息接收方號(hào)碼的類型6.3.8DestTermPseudoTLV短消息接收方的偽碼6.3.9PkTotalTLV相同MsgID的消息總條數(shù)6.3.10PkNumberTLV相同MsgID的消息序號(hào)6.3.11SubmitMsgTypeTLVSP發(fā)送的消息類型6.3.12SPDealResultTLVSP對(duì)消息的處理結(jié)果6.3.13MServiceIDTLV業(yè)務(wù)代碼(用于移動(dòng)網(wǎng)業(yè)務(wù))6.3.19短信平臺(tái)支持短信的群發(fā)功能,關(guān)于短信群發(fā)功能的實(shí)現(xiàn)請(qǐng)參閱“附錄B短消息群發(fā)功能的實(shí)現(xiàn)”。Submit_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)MsgID10OctetString短消息流水號(hào)6.2.26Status4Integer請(qǐng)求返回結(jié)果6.2.6SMGW向SP下發(fā)短消息的操作(Deliver)Deliver字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)MsgID10OctetString短消息流水號(hào)6.2.26IsReport1Integer是否為狀態(tài)報(bào)告6.2.27MsgFormat1Integer短消息格式6.2.RecvTime14OctetString短消息接收時(shí)間6.2.28SrcTermID21OctetString短消息發(fā)送號(hào)碼6.2.19DestTermID21OctetString短消息接收號(hào)碼6.2.22MsgLength1Integer短消息長(zhǎng)度6.2.23MsgContentMsgLengthOctetString短消息內(nèi)容6.2.24Reserve8OctetString保留6.2.25可選參數(shù)字段數(shù)據(jù)類型說(shuō)明參考TP_pidTLVGSM協(xié)議類型6.3.2TP_udhiTLVGSM協(xié)議類型6.3.3LinkIDTLV交易標(biāo)識(shí)6.3.4SrcTermTypeTLV短消息發(fā)送方的號(hào)碼類型6.3.14SrcTermPseudoTLV短消息發(fā)送方的偽碼6.3.15SubmitMsgTypeTLVSP發(fā)送的消息類型6.3.12SPDealResultTLVSP對(duì)消息的處理結(jié)果6.3.13Deliver_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)MsgID10OctetString短消息流水號(hào)6.2.26Status4Integer請(qǐng)求返回結(jié)果6.2.6源SMGW向目的SMGW轉(zhuǎn)發(fā)短消息的操作(Forward)Forward字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)MsgID10OctetString短消息流水號(hào)6.2.26DestSMGWNo6OctetString目的SMGW代碼6.2.29SrcSMGWNo6OctetString源SMGW代碼6.2.30SMCNo6OctetString短消息中心代碼6.2.31MsgType1Integer短消息類型6.2.9ReportFlag1Integer狀態(tài)報(bào)告標(biāo)志6.2.32Priority1Integer短消息發(fā)送優(yōu)先級(jí)6.2.11ServiceID10OctetString業(yè)務(wù)代碼6.2.12FeeType2OctetString資費(fèi)類型6.2.13FeeCode6OctetString資費(fèi)代碼6.2.14FixedFee6OctetString包月費(fèi)/封頂費(fèi)6.2.15MsgFormat1Integer短消息格式6.2.16ValidTime17OctetString有效時(shí)間6.2.17AtTime17OctetString定時(shí)發(fā)送時(shí)間6.2.18SrcTermID21OctetString短消息發(fā)送用戶號(hào)碼6.2.19DestTermID21OctetString短消息接收用戶號(hào)碼6.2.22ChargeTermID21OctetString計(jì)費(fèi)用戶號(hào)碼6.2.20MsgLength1Integer短消息長(zhǎng)度6.2.23MsgContentMsgLengthOctetString短消息內(nèi)容6.2.24Reserve8OctetString保留6.2.25可選參數(shù)字段數(shù)據(jù)類型說(shuō)明參考TP_pidTLVGSM協(xié)議類型6.3.2TP_udhiTLVGSM協(xié)議類型6.3.3LinkIDTLV交易標(biāo)識(shí)6.3.4ChargeUserTypeTLV計(jì)費(fèi)用戶類型6.3.5NodesCountTLV經(jīng)過(guò)的網(wǎng)關(guān)數(shù)量6.3.16MsgSrcTLV信息內(nèi)容的來(lái)源6.3.17ChargeTermPseudoTLV計(jì)費(fèi)用戶的偽碼6.3.7SrcTermPseudoTLV短消息發(fā)送方的偽碼6.3.14DestTermPseudoTLV短消息接收方的偽碼6.3.15SrcTypeTLV傳遞給SP的源號(hào)碼的類型6.3.18PkTotalTLV相同MsgID的消息總條數(shù)6.3.10PkNumberTLV相同MsgID的消息序號(hào)6.3.11SubmitMsgTypeTLVSP發(fā)送的消息類型6.3.12SPDealResultTLVSP對(duì)消息的處理結(jié)果6.3.13MServiceIDTLV業(yè)務(wù)代碼(用于移動(dòng)網(wǎng)業(yè)務(wù))6.3.19Forward_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)MsgID10OctetStringSMGW產(chǎn)生的短消息流水號(hào)6.2.26Status4Integer請(qǐng)求返回結(jié)果6.2.6可選參數(shù)字段數(shù)據(jù)類型說(shuō)明參考PkTotalTLV相同MsgID的消息總條數(shù)6.3.10PkNumberTLV相同MsgID的消息序號(hào)6.3.11鏈路檢測(cè)操作(Active_Test)本操作僅適用于通信雙方采用長(zhǎng)連接通信方式時(shí)用于保持連接。Active_Test無(wú)消息體。Active_Test_Resp無(wú)消息體。請(qǐng)求關(guān)閉連接的操作(Exit)Exit操作的目的是客戶端或服務(wù)器端基于某些原因決定拆除當(dāng)前的應(yīng)用層連接而發(fā)起的操作。此操作完成后客戶端與服務(wù)器端的應(yīng)用層連接被釋放,此后通信時(shí)應(yīng)由客戶端重新發(fā)起Login操作。Exit無(wú)消息體。Exit_Resp無(wú)消息體。SP向SMGW查詢短消息發(fā)送狀態(tài)的操作(Query,可選)Query字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)QueryTime8OctetString查詢時(shí)間6.2.33QueryType1Integer查詢類別6.2.34QueryCode10OctetString查詢碼6.2.35Query_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)QueryTime8OctetString查詢時(shí)間6.2.33QueryType1Integer查詢類別6.2.34QueryCode10OctetString查詢碼(業(yè)務(wù)類型)6.2.35MT_TLMsg4Integer接收短消息總數(shù)6.2.36MT_Tlusr4Integer接收用戶總數(shù)6.2.37MT_Scs4Integer成功轉(zhuǎn)發(fā)數(shù)量6.2.38MT_WT4Integer待轉(zhuǎn)發(fā)數(shù)量6.2.39MT_FL4Integer轉(zhuǎn)發(fā)失敗數(shù)量6.2.40MO_Scs4Integer成功送達(dá)數(shù)量6.2.41MO_WT4Integer待送達(dá)數(shù)量6.2.42MO_FL4Integer送達(dá)失敗數(shù)量6.2.43Reverse8OctetString保留6.2.25SMGW向GNS查詢終端路由的操作(Query_TE_Route,可選)Query_TE_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)SrcGatewayID6OctetString源網(wǎng)關(guān)代碼6.2.44QueryTermID21OctetString查詢號(hào)碼6.2.45Query_TE_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49TermRangeID10OctetString路由號(hào)碼段6.2.50ProvinceCode4OctetString終端所屬省代號(hào)6.2.51UserType1Integer用戶類型(該字段保留)6.2.52Time14OctetString時(shí)間戳6.2.53SMGW向GNS查詢SP路由的操作(Query_SP_Route,可選)Query_SP_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)SrcGatewayID6OctetString源網(wǎng)關(guān)代碼6.2.44QueryTermID21OctetString查詢號(hào)碼6.2.45Query_SP_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49SPID8OctetStringSP的企業(yè)代碼6.2.54SPCode21OctetStringSP的服務(wù)代碼6.2.55SPAccessType1IntegerSP接入類型6.2.56SPType1IntegerSP類型6.2.57Time14OctetString時(shí)間戳6.2.53SMGW向GNS獲取所有終端路由的操作(Get_All_TE_Route,可選)Get_All_TE_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)SrcGatewayID6OctetString源網(wǎng)關(guān)代碼6.2.44RouteType4OctetString路由類型6.2.58LastRouteID4Integer已經(jīng)接收的上一條路由編號(hào)6.2.59Get_All_TE_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49TermRangeID10OctetString路由號(hào)碼段6.2.50ProvinceCode4OctetString終端所屬省代號(hào)6.2.51UserType1Integer用戶類型(該字段保留)6.2.52RouteTotal4Integer返回路由總數(shù)6.2.60RouteNumber4Integer當(dāng)前返回的路由序號(hào)6.2.61Time14OctetString時(shí)間戳6.2.53SMGW向GNS獲取所有SP路由的操作(Get_All_SP_Route,可選)Get_All_SP_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)SrcGatewayID6OctetString源網(wǎng)關(guān)代碼6.2.44RouteType4OctetString路由類型6.2.58LastRouteID4Integer已經(jīng)接收的上一條路由編號(hào)6.2.59Get_All_SP_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49SPID8OctetStringSP的企業(yè)代碼6.2.54SPCode21OctetStringSP的服務(wù)代碼6.2.55SPAccessType1IntegerSP接入類型6.2.56SPType1IntegerSP類型6.2.57RouteTotal4Integer返回路由總數(shù)6.2.60RouteNumber4Integer當(dāng)前返回的路由序號(hào)6.2.61Time14OctetString時(shí)間戳6.2.53SMGW向GNS更新終端路由的操作(Update_TE_Route,可選)Update_TE_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)UpdateType1Integer更新類型6.2.62RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49TermRangeID10OctetString路由號(hào)碼段6.2.50ProvinceCode4OctetString終端所屬省代號(hào)6.2.51UserType1Integer用戶類型(該字段保留)6.2.52Update_TE_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6RouteID4Integer路由編號(hào)6.2.46Time14OctetString時(shí)間戳6.2.53SMGW向GNS更新SP路由的操作(Update_SP_Route,可選)Update_SP_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)UpdateType1Integer更新類型6.2.62RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49SPID8OctetStringSP的企業(yè)代碼6.2.54SPCode21OctetStringSP的服務(wù)代碼6.2.55SPAccessType1IntegerSP接入類型6.2.56SPType1IntegerSP類型6.2.57Update_SP_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6RouteID4Integer路由編號(hào)6.2.46Time14OctetString時(shí)間戳6.2.53GNS向SMGW更新終端路由的操作(Push_Update_TE_Route,可選)Push_Update_TE_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)UpdateType1Integer更新類型6.2.62RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49TermRangeID10OctetString路由號(hào)碼段6.2.50ProvinceCode4OctetString終端所屬省代號(hào)6.2.51UserType1Integer用戶類型(該字段保留)6.2.52Time14OctetString時(shí)間戳6.2.53Push_Update_TE_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6GNS向SMGW更新SP路由的操作(Push_Update_SP_Route,可選)Push_Update_SP_Route字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)UpdateType1Integer更新類型6.2.62RouteID4Integer路由編號(hào)6.2.46DestGatewayID6OctetString目標(biāo)網(wǎng)關(guān)代碼6.2.47DestGatewayIP15OctetString目標(biāo)網(wǎng)關(guān)IP地址6.2.48DestGatewayPort2Integer目標(biāo)網(wǎng)關(guān)IP端口6.2.49SPID8OctetStringSP的企業(yè)代碼6.2.54SPCode21OctetStringSP的服務(wù)代碼6.2.55SPAccessType1IntegerSP接入類型6.2.56SPType1IntegerSP類型6.2.57Time14OctetString時(shí)間戳6.2.53Push_Update_SP_Route_Resp字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明參考必選參數(shù)Status4Integer請(qǐng)求返回結(jié)果6.2.6

參數(shù)定義消息頭參數(shù)描述PacketLengthSMGP數(shù)據(jù)包長(zhǎng)度,指包頭和包體的長(zhǎng)度之和。單位是“字節(jié)”。RequestId請(qǐng)求標(biāo)識(shí)表示SMGP數(shù)據(jù)包的類型,請(qǐng)求包的請(qǐng)求標(biāo)識(shí)和應(yīng)答包的請(qǐng)求標(biāo)識(shí)一一對(duì)應(yīng)。SMGP協(xié)議的請(qǐng)求標(biāo)識(shí)定義如下:請(qǐng)求名稱請(qǐng)求標(biāo)識(shí)說(shuō)明Login0x00000001客戶端登錄Login_Resp0x80000001客戶端登錄應(yīng)答Submit0x00000002提交短消息Submit_Resp0x80000002提交短消息應(yīng)答Deliver0x00000003下發(fā)短消息Deliver_Resp0x80000003下發(fā)短消息應(yīng)答Active_Test0x00000004鏈路檢測(cè)Active_Test_Resp0x80000004鏈路檢測(cè)應(yīng)答Forward0x00000005短消息前轉(zhuǎn)Forward_Resp0x80000005短消息前轉(zhuǎn)應(yīng)答Exit0x00000006退出請(qǐng)求Exit_Resp0x80000006退出應(yīng)答Query0x00000007SP統(tǒng)計(jì)查詢Query_Resp0x80000007SP統(tǒng)計(jì)查詢應(yīng)答Query_TE_Route0x00000008查詢TE路由Query_TE_Route_Resp0x80000008查詢TE路由應(yīng)答Query_SP_Route0x00000009查詢SP路由Query_SP_Route_Resp0x80000009查詢SP路由應(yīng)答Payment_Request0x0000000A扣款請(qǐng)求(用于預(yù)付費(fèi)系統(tǒng),參見增值業(yè)務(wù)計(jì)費(fèi)方案)Payment_Request_Resp0x8000000A扣款請(qǐng)求響應(yīng)(用于預(yù)付費(fèi)系統(tǒng),參見增值業(yè)務(wù)計(jì)費(fèi)方案,下同)Payment_Affirm0x0000000B扣款確認(rèn)(用于預(yù)付費(fèi)系統(tǒng),參見增值業(yè)務(wù)計(jì)費(fèi)方案)Payment_Affirm_Resp0x8000000B扣款確認(rèn)響應(yīng)(用于預(yù)付費(fèi)系統(tǒng),參見增值業(yè)務(wù)計(jì)費(fèi)方案)Query_UserState0x0000000C查詢用戶狀態(tài)(用于預(yù)付費(fèi)系統(tǒng),參見增值業(yè)務(wù)計(jì)費(fèi)方案)Query_UserState_Resp0x8000000C查詢用戶狀態(tài)響應(yīng)(用于預(yù)付費(fèi)系統(tǒng),參見增值業(yè)務(wù)計(jì)費(fèi)方案)Get_All_TE_Route0x0000000D獲取所有終端路由Get_All_TE_Route_Resp0x8000000D獲取所有終端路由應(yīng)答Get_All_SP_Route0x0000000E獲取所有SP路由Get_All_SP_Route_Resp0x8000000E獲取所有SP路由應(yīng)答Update_TE_Route0x0000000FSMGW向GNS更新終端路由Update_TE_Route_Resp0x8000000FSMGW向GNS更新終端路由應(yīng)答Update_SP_Route0x00000010SMGW向GNS更新SP路由Update_SP_Route_Resp0x80000010SMGW向GNS更新SP路由應(yīng)答Push_Update_TE_Route0x00000011GNS向SMGW更新終端路由Push_Update_TE_Route_Resp0x80000011GNS向SMGW更新終端路由應(yīng)答Push_Update_SP_Route0x00000012GNS向SMGW更新SP路由Push_Update_SP_Route_Resp0x80000012GNS向SMGW更新SP路由應(yīng)答其它保留SequenceIdSMGP消息流水號(hào),用來(lái)匹配請(qǐng)求數(shù)據(jù)包和應(yīng)答數(shù)據(jù)包。應(yīng)答數(shù)據(jù)包的流水號(hào)字段必須與請(qǐng)求包的流水號(hào)字段一致。流水號(hào)字段由請(qǐng)求包發(fā)起方分配,取值范圍為0x00000000-0xFFFFFFFF,順序累加,步長(zhǎng)為1,循環(huán)使用。消息體必選參數(shù)描述ClientID客戶端用來(lái)登錄服務(wù)器端的用戶賬號(hào)。當(dāng)客戶端為SP時(shí),用戶帳號(hào)為SP服務(wù)代碼;當(dāng)客戶端為SMGW時(shí),用戶帳號(hào)為SMGW代碼;當(dāng)客戶端為GNS時(shí),用戶帳號(hào)為GNS代碼。AuthenticatorClient客戶端認(rèn)證碼,用來(lái)鑒別客戶端的合法性。其值通過(guò)單向MD5hash計(jì)算得出,表示如下:AuthenticatorClient=MD5(ClientID+7字節(jié)的二進(jìn)制0(0x00)+Sharedsecret+Timestamp)Sharedsecret由服務(wù)器端與客戶端事先商定,最長(zhǎng)15字節(jié)。此處Timestamp格式為:MMDDHHMMSS(月日時(shí)分秒),經(jīng)TimeStamp字段值轉(zhuǎn)換成字符串,轉(zhuǎn)換后右對(duì)齊,左補(bǔ)0x30得到。例如3月1日0時(shí)0分0秒,TimeStamp字段值為0x11F0E540,此處為0301000000。LoginMode客戶端用來(lái)登錄服務(wù)器端的登錄模式。0=發(fā)送短消息(sendmode);1=接收短消息(receivemode);2=收發(fā)短消息(transmitmode);其它保留。TimeStamp時(shí)間戳。例如3月1日0時(shí)0分0秒,用于MD5計(jì)算時(shí)為0301000000,此處轉(zhuǎn)換為整型數(shù)即為11F0E540。ClientVersion客戶端支持的協(xié)議版本號(hào)。高4bit表示主版本號(hào),低4bit表示次版本號(hào)。例如0x13,表示協(xié)議版本號(hào)為1.3。Status請(qǐng)求返回結(jié)果。響應(yīng)包用來(lái)向請(qǐng)求包返回成功信息或者失敗原因。SMGP協(xié)議的結(jié)果碼定義如下:代碼含義0成功1系統(tǒng)忙2超過(guò)最大連接數(shù)3-9保留10消息結(jié)構(gòu)錯(cuò)11命令字錯(cuò)12序列號(hào)重復(fù)13-19保留20IP地址錯(cuò)21認(rèn)證錯(cuò)22版本太高23-29保留30非法消息類型(MsgType)31非法優(yōu)先級(jí)(Priority)32非法資費(fèi)類型(FeeType)33非法資費(fèi)代碼(FeeCode)34非法短消息格式(MsgFormat)35非法時(shí)間格式36非法短消息長(zhǎng)度(MsgLength)37有效期已過(guò)38非法查詢類別(QueryType)39路由錯(cuò)誤40非法包月費(fèi)/封頂費(fèi)(FixedFee)41非法更新類型(UpdateType)42非法路由編號(hào)(RouteId)43非法服務(wù)代碼(ServiceId)44非法有效期(ValidTime)45非法定時(shí)發(fā)送時(shí)間(AtTime)46非法發(fā)送用戶號(hào)碼(SrcTermId)47非法接收用戶號(hào)碼(DestTermId)48非法計(jì)費(fèi)用戶號(hào)碼(ChargeTermId)49非法SP服務(wù)代碼(SPCode)50~55其它用途56非法源網(wǎng)關(guān)代碼(SrcGatewayID)57非法查詢號(hào)碼(QueryTermID)58沒有匹配路由59非法SP類型(SPType)60非法上一條路由編號(hào)(LastRouteID)61非法路由類型(RouteType)62非法目標(biāo)網(wǎng)關(guān)代碼(DestGatewayID)63非法目標(biāo)網(wǎng)關(guān)IP(DestGatewayIP)64非法目標(biāo)網(wǎng)關(guān)端口(DestGatewayPort)65非法路由號(hào)碼段(TermRangeID)66非法終端所屬省代碼(ProvinceCode)67非法用戶類型(UserType)68本節(jié)點(diǎn)不支持路由更新69非法SP企業(yè)代碼(SPID)70非法SP接入類型(SPAccessType)71路由信息更新失敗72非法時(shí)間戳(Time)73非法業(yè)務(wù)代碼(MServiceID)74SP禁止下發(fā)時(shí)段75SP發(fā)送超過(guò)日流量76SP帳號(hào)過(guò)有效期112~116其它用途128-255廠家自定義其它保留AuthenticatorServerLogin服務(wù)器端返回給客戶端的認(rèn)證碼,當(dāng)客戶端認(rèn)證出錯(cuò)時(shí),此項(xiàng)為空。其值通過(guò)單向MD5hash計(jì)算得出,表示如下:AuthenticatorServer=MD5(Status+AuthenticatorClient+Sharedsecret)Sharedsecret由服務(wù)器端與客戶端事先商定,最長(zhǎng)15字節(jié)AuthenticatorClient為客戶端發(fā)送給服務(wù)器端的Login中的值。參見6.2.2節(jié)。ServerVersion服務(wù)器端支持的最高版本號(hào)。高4bit表示主版本號(hào),低4bit表示次版本號(hào)。例如0x13,表示協(xié)議版本號(hào)1.3。MsgType短消息類型。對(duì)于回執(zhí)消息該字段無(wú)效;對(duì)于文本短消息,該字段表示短消息的消息流向:0=MO消息(終端發(fā)給SP);6=MT消息(SP發(fā)給終端,包括WEB上發(fā)送的點(diǎn)對(duì)點(diǎn)短消息);7=點(diǎn)對(duì)點(diǎn)短消息;其它保留。NeedReport是否要求返回狀態(tài)報(bào)告。0=不要求返回狀態(tài)報(bào)告;1=要求返回狀態(tài)報(bào)告;其它保留。Priority短消息發(fā)送優(yōu)先級(jí)。0=低優(yōu)先級(jí);1=普通優(yōu)先級(jí);2=較高優(yōu)先級(jí);3=高優(yōu)先級(jí);其它保留。ServiceID業(yè)務(wù)代碼,用于固定網(wǎng)業(yè)務(wù)。對(duì)于MO消息或點(diǎn)對(duì)點(diǎn)短消息,該字段無(wú)效;對(duì)于MT消息,該字段表示業(yè)務(wù)代碼,是該條短消息所屬的業(yè)務(wù)類別,由數(shù)字、字母和符號(hào)組合而成。對(duì)于從WEB上發(fā)送的點(diǎn)對(duì)點(diǎn)短消息,要求業(yè)務(wù)代碼為“PC2P”,其它業(yè)務(wù)代碼由SP自定義。FeeType對(duì)計(jì)費(fèi)用戶采取的收費(fèi)類型。對(duì)于MO消息或點(diǎn)對(duì)點(diǎn)短消息,該字段無(wú)效。對(duì)于MT消息,該字段用法如下:00=免費(fèi),此時(shí)FixedFee和FeeCode無(wú)效;01=按條計(jì)信息費(fèi),此時(shí)FeeCode表示每條費(fèi)用,F(xiàn)ixedFee無(wú)效;02=按包月收取信息費(fèi),此時(shí)FeeCode無(wú)效,F(xiàn)ixedFee表示包月費(fèi)用;03=按封頂收取信息費(fèi),若按條收費(fèi)的費(fèi)用總和達(dá)到或超過(guò)封頂費(fèi)后,則按照封頂費(fèi)用收取信息費(fèi);若按條收費(fèi)的費(fèi)用總和沒有達(dá)到封頂費(fèi)用,則按照每條費(fèi)用總和收取信息費(fèi)。FeeCode表示每條費(fèi)用,F(xiàn)ixedFee表示封頂費(fèi)用。其它保留。FeeCode每條短消息費(fèi)率,單位為“分”。對(duì)于MO消息或點(diǎn)對(duì)點(diǎn)短消息,該字段無(wú)效;對(duì)于MT消息,該字段具體使用方法參見6.2.13節(jié)。FixedFee短消息的包月費(fèi)/封頂費(fèi),單位為“分”。對(duì)于MO消息或點(diǎn)對(duì)點(diǎn)短消息,該字段無(wú)效;對(duì)于MT消息,該字段具體使用方法參見6.2.13節(jié)。MsgFormat短消息內(nèi)容體的編碼格式。0=ASCII編碼;3=短消息寫卡操作;4=二進(jìn)制短消息;8=UCS2編碼;15=GB18030編碼;246(F6)=(U)SIM相關(guān)消息;其它保留。對(duì)于文字短消息,要求MsgFormat=15。對(duì)于回執(zhí)消息,要求MsgFormat=0。ValidTime短消息有效時(shí)間,格式遵循SMPP3.3以上版本協(xié)議。短消息有效時(shí)間在轉(zhuǎn)發(fā)過(guò)程中保持不變。AtTime短消息定時(shí)發(fā)送時(shí)間,格式遵循SMPP3.3以上版本協(xié)議。短消息定時(shí)發(fā)送時(shí)間在轉(zhuǎn)發(fā)過(guò)程中保持不變。SrcTermID短消息發(fā)送方號(hào)碼。對(duì)于MT消息,SrcTermID格式為“118+SP服務(wù)代碼+其它(可選)”,例如SP服務(wù)代碼為1234時(shí),SrcTermID可以為1181234或118123456等。對(duì)于MO消息,固定網(wǎng)中SrcTermID格式為“區(qū)號(hào)+號(hào)碼(區(qū)號(hào)前添零)”,例如02087310323,07558780808,移動(dòng)網(wǎng)中SrcTermID格式為MSISDN號(hào)碼格式。對(duì)于固定網(wǎng)點(diǎn)對(duì)點(diǎn)消息,主叫號(hào)碼為普通終端時(shí),SrcTermID格式為“區(qū)號(hào)+號(hào)碼(區(qū)號(hào)前添零)”;主叫號(hào)碼為愛因平臺(tái)時(shí),SrcTermID格式為“10631+區(qū)號(hào)+號(hào)碼(區(qū)號(hào)前添零)”。ChargeTermID計(jì)費(fèi)用戶號(hào)碼。ChargeTermID為空時(shí),如果是MT消息,則表示對(duì)被叫用戶號(hào)碼計(jì)費(fèi);如果是MO或點(diǎn)對(duì)點(diǎn)消息,則表示對(duì)主叫用戶號(hào)碼計(jì)費(fèi)。ChargeTermID為非空時(shí),表示對(duì)計(jì)費(fèi)用戶號(hào)碼計(jì)費(fèi)。DestTermIDCount短消息接收號(hào)碼總數(shù)(≤100),用于SP實(shí)現(xiàn)群發(fā)短消息。DestTermID短消息接收號(hào)碼。對(duì)于MT消息,DestTermID連續(xù)存儲(chǔ)DestTermIDCount個(gè)號(hào)碼,每一個(gè)接收方號(hào)碼為21位,固定網(wǎng)中DestTermID格式為“區(qū)號(hào)+號(hào)碼(區(qū)號(hào)前添零)”,移動(dòng)網(wǎng)中DestTermID格式為MSISDN號(hào)碼格式,不足21位時(shí)應(yīng)左對(duì)齊,右補(bǔ)0x00。對(duì)于MO消息,DestTermID格式為“118+SP服務(wù)代碼+其它(可選)”。對(duì)于點(diǎn)對(duì)點(diǎn)短消息,DestTermID格式為“區(qū)號(hào)+號(hào)碼(區(qū)號(hào)前添零)”,不足21位時(shí)應(yīng)左對(duì)齊,右補(bǔ)0x00。對(duì)于固定網(wǎng)點(diǎn)對(duì)點(diǎn)消息,被叫號(hào)碼為普通終端時(shí),SrcTermID格式為“區(qū)號(hào)+號(hào)碼(區(qū)號(hào)前添零)”;被叫號(hào)碼為愛因平臺(tái)時(shí),SrcTermID格式為“10631+區(qū)號(hào)+號(hào)碼(區(qū)號(hào)前添零)”。MsgLength短消息長(zhǎng)度。指MsgContent域的長(zhǎng)度,取值大于或等于0。對(duì)于MT消息,取值應(yīng)小于或等于140。MsgContent短消息內(nèi)容。當(dāng)IsReport=1時(shí),MsgContent中內(nèi)容為狀態(tài)報(bào)告,其格式遵循6.2.63節(jié)描述。Reserve保留字段。MsgID短消息流水號(hào),用來(lái)唯一標(biāo)識(shí)一條短消息。該字段在短消息的轉(zhuǎn)發(fā)處理流程中保持唯一。MsgId字段包含以下三部分內(nèi)容:SMGW代碼:3字節(jié)(BCD碼)編碼規(guī)則如下:3位區(qū)號(hào)(不足前添0)+2位設(shè)備類別+1位序號(hào)區(qū)號(hào):所在省長(zhǎng)途區(qū)號(hào)設(shè)備類別:SMGW取06序號(hào):所在省的設(shè)備編碼,例如第一個(gè)網(wǎng)關(guān)編號(hào)為1時(shí)間:4字節(jié)(BCD碼),格式為MMDDHHMM(月日時(shí)分)序列號(hào):3字節(jié)(BCD碼),取值范圍為000000~999999,從0開始,順序累加,步長(zhǎng)為1,循環(huán)使用。例如某SMGW的代碼為010061,在2003年1月16日下午5時(shí)0分收到一條短消息,這條短消息的MsgID為:0x01006101161700012345,其中010061表示SMGW代碼,01161700表示接收時(shí)間,012345表示消息序列號(hào)。IsReport是否為狀態(tài)報(bào)告。0=不是狀態(tài)報(bào)告;1=是狀態(tài)報(bào)告;其它保留。RecvTimeSMGW接收到短消息的時(shí)間。格式為YYYYMMDDHHMMSS(年年年年月月日日時(shí)時(shí)分分秒秒)。DestSMGWNo目的SMGW代碼,指短消息前轉(zhuǎn)的下一個(gè)SMGW代碼。SrcSMGWNo源SMGW代碼,指短消息前轉(zhuǎn)的本SMGW代碼。SMCNo發(fā)送方短消息中心代碼。ReportFlag狀態(tài)報(bào)告標(biāo)志。0=是狀態(tài)報(bào)告;1=要求狀態(tài)報(bào)告;2=不要求狀態(tài)報(bào)告;其它保留。QueryTime查詢時(shí)間。格式:YYYYMMDD(年年年年月月日日),精確到日。QueryType查詢類別。0:總數(shù)查詢1:按業(yè)務(wù)代碼查詢其它保留QueryCode查詢碼(業(yè)務(wù)類型)。當(dāng)Query_Type為0時(shí),此項(xiàng)無(wú)效;當(dāng)Query_Type為1時(shí),此項(xiàng)填寫業(yè)務(wù)代碼Service_id。MT_TLMsg接收短消息總數(shù)。MT_TLUsr接收用戶總數(shù)。MT_Scs成功轉(zhuǎn)發(fā)數(shù)量。MT_WT待轉(zhuǎn)發(fā)數(shù)量。MT_FL轉(zhuǎn)發(fā)失敗數(shù)量。MO_Scs成功送達(dá)數(shù)量。MO_WT待送達(dá)數(shù)量。MO_FL送達(dá)失敗數(shù)量。SrcGatewayID源SMGW代碼。QueryTermID查詢號(hào)碼,表示要查詢的被叫號(hào)碼。RouteId路由編號(hào)。終端和SP的路由分別從0開始,由GNS統(tǒng)一分配。在SMGW向GNS發(fā)起的路由更新請(qǐng)求消息(包括終端路由更新和SP路由更新)中,當(dāng)UpdateType為“添加”時(shí)此字段為0;在路由更新應(yīng)答消息中,當(dāng)UpdateType為“更新”或“刪除”時(shí)返回原路由編號(hào),當(dāng)路由更新類型為“添加”時(shí)返回新分配的路由編號(hào)。DestGatewayID目的SMGW代碼。DestGatewayIP目的SMGWIP地址。例如IP地址為:67.221.134.12,則該字段填寫為0x36372E3232312E3133342E3132。DestGatewayPort目的SMGWIP端口。TermRangeID路由號(hào)碼段。ProvinceCode終端所屬省代號(hào)。UserType用戶類型。該字段保留。Time時(shí)間戳。表示本路由信息的最后修改時(shí)間或更新請(qǐng)求收到時(shí)間,格式為:YYYYMMDDHHMMSS(年年年年月月日日時(shí)時(shí)分分秒秒),例如2004年9月1日2時(shí)13分24秒,即為20040901021324。SPIDSP的企業(yè)代碼。SPCodeSP的服務(wù)代碼。SPAccessTypeSP接入類型。0=全網(wǎng)業(yè)務(wù)SP全網(wǎng)接入,即接入網(wǎng)關(guān)為SP的主力接入點(diǎn);1=全網(wǎng)業(yè)務(wù)SP鏡像接入,即接入網(wǎng)關(guān)為SP的鏡像接入點(diǎn);其它保留。SPTypeSP類型。0=本地性SP;1=全國(guó)性SP;其它保留。RouteType路由類型。TE=終端路由;SP=SP路由;其它保留。LastRouteID已經(jīng)接收的上一條路由編號(hào),初始值為0。RouteTotal返回路由總數(shù)。RouteNumber當(dāng)前返回的路由序號(hào),從1開始,順序遞增。UpdateType更新類別。0=添加;1=刪除;2=更新其它保留狀態(tài)報(bào)告格式注:“狀態(tài)報(bào)告格式”采用SMPPV3.4中的規(guī)定,即“id:IIIIIIIIIIsub:SSSdlvrd:DDDSubmitdate:YYMMDDhhmmdonedate:YYMMDDhhmmstat:DDDDDDDerr:EText:……”。字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Id10OctetString狀態(tài)報(bào)告對(duì)應(yīng)原短消息的MsgIDsub3OctetString取缺省值001Dlvrd3OctetString取缺省值001Submit_date10OctetString短消息提交時(shí)間(格式:年年月月日日時(shí)時(shí)分分,例如010331200000)done_date10OctetString短消息下發(fā)時(shí)間(格式:年年月月日日時(shí)時(shí)分分,例如010331200000)Stat7OctetString短消息的最終狀態(tài)(參見第6.2.63.1節(jié)短消息狀態(tài)表)Err3OctetString參見第6.2.63.2節(jié)錯(cuò)誤代碼表Txt20OctetString前3個(gè)字節(jié),表示短消息長(zhǎng)度(用ASCII碼表示),后17個(gè)字節(jié)表示短消息的內(nèi)容(保證內(nèi)容不出現(xiàn)亂碼)短消息狀態(tài)表狀態(tài)名狀態(tài)值(字符串)說(shuō)明DELIVEREDDELIVRD短消息轉(zhuǎn)發(fā)成功EXPIREDEXPIRED短消息超過(guò)有效期DELETEDDELETED短消息已經(jīng)被刪除UNDELIVERABLEUNDELIV短消息是不可轉(zhuǎn)發(fā)的ACCEPTEDACCEPTD短消息已經(jīng)被最終用戶接收(為保持與SMPP兼容,保留)UNKNOWNUNKNOWN未知短消息狀態(tài)REJECTEDREJECTD短消息被拒絕(為保持與SMPP兼容,保留)Err錯(cuò)誤代碼表狀態(tài)值(字符串)說(shuō)明對(duì)應(yīng)狀態(tài)000成功DELIVRD001用戶不能通信EXPIRED002用戶忙EXPIRED003終端無(wú)此部件號(hào)UNDELIV004非法用戶UNDELIV005用戶在黑名單內(nèi)UNDELIV006系統(tǒng)錯(cuò)誤UNDELIV007用戶內(nèi)存滿EXPIRED008非信息終端UNDELIV009數(shù)據(jù)錯(cuò)誤UNDELIV010數(shù)據(jù)丟失UNDELIV999未知錯(cuò)誤UNKNOWN消息體可選參數(shù)描述可選參數(shù)標(biāo)簽定義標(biāo)簽名稱標(biāo)簽值TP_pid0x0001TP_udhi0x0002LinkID0x0003ChargeUserType0x0004ChargeTermType0x0005ChargeTermPseudo0x0006DestTermType0x0007DestTermPseudo0x0008PkTotal0x0009PkNumber0x000ASubmitMsgType0x000BSPDealReslt0x000CSrcTermType0x000DSrcTermPseudo0x000ENodesCount0x000FMsgSrc0x0010SrcType0x0011MServiceID0x0012TP_pid字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerTP_pid標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1IntegerGSM協(xié)議類型。詳細(xì)解釋請(qǐng)參考GSM03.40中的9.2.3.9。TP_udhi字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerTP_udhi標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1IntegerGSM協(xié)議類型。詳細(xì)解釋請(qǐng)參考GSM03.40中的9.2.3.23,僅使用1位,右對(duì)齊。LinkID字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerLinkID標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value20OctetString交易標(biāo)識(shí),用于唯一標(biāo)識(shí)一次交易ChargeUserType字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerChargeUserType標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer計(jì)費(fèi)用戶類型。0=對(duì)短消息接收方計(jì)費(fèi);1=對(duì)短消息發(fā)送方計(jì)費(fèi);2=對(duì)SP計(jì)費(fèi);3=表示本字段無(wú)效,對(duì)誰(shuí)計(jì)費(fèi)參見ChargeTermID或ChargeTermPseudo字段。ChargeTermType字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerChargeTermType標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer計(jì)費(fèi)用戶的號(hào)碼類型。0=真實(shí)號(hào)碼;1=偽碼;其它保留。ChargeTermPseudo字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerChargeTermPseudo標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度ValueLengthOctetString計(jì)費(fèi)用戶的偽碼DestTermType字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerDestTermType標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer短消息接收方的號(hào)碼類型。0=真實(shí)號(hào)碼;1=偽碼;其它保留。DestTermPseudo字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerDestTermPseudo標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度ValueLengthOctetString短消息接收方的偽碼,當(dāng)有多個(gè)接收方偽碼時(shí),要求每個(gè)接收方偽碼的長(zhǎng)度一樣。PkTotal字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerPkTotal標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer相同Msg_Id的消息總條數(shù)。PkNumber字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerPkNumber標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer相同Msg_Id的消息序號(hào),從1開始。SubmitMsgType字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerSubmitMsgType標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1IntegerSP發(fā)送的消息類型。0=普通短消息;1=WEB方式訂閱通知消息;2=WEB方式取消訂閱通知消息;3=終端方式訂閱通知消息;4=終端方式取消訂閱通知消息;5=包月扣費(fèi)通知消息;其它保留。SPDealResult字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerSPDealResult標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1IntegerSP對(duì)消息的處理結(jié)果0=訂閱/取消訂閱/扣費(fèi)成功;1=訂閱/取消訂閱/扣費(fèi)失?。黄渌A?。該字段在SubmitMsgType為0時(shí)無(wú)效。SrcTermType字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerSrcTermType標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer短消息發(fā)送方的號(hào)碼類型。0=真實(shí)號(hào)碼;1=偽碼;其它保留。SrcTermPseudo字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerSrcTermPseudo標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度ValueLengthOctetString短消息發(fā)送方的偽碼NodesCount字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerNodesCount標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer經(jīng)過(guò)的網(wǎng)關(guān)數(shù)量。該字段的初始值為1。MsgSrc字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerMsgSrc標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value8OctetString信息內(nèi)容的來(lái)源。在固定網(wǎng)短消息業(yè)務(wù)中,MsgSrc填寫SP的服務(wù)代碼。在移動(dòng)網(wǎng)短消息業(yè)務(wù)中,MsgSrc填寫SP的企業(yè)代碼。SrcType字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerSrcType標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value1Integer傳遞給SP的源號(hào)碼的類型。0=真實(shí)號(hào)碼;1=偽碼;其它保留。MServiceID字段長(zhǎng)度(字節(jié))數(shù)據(jù)類型說(shuō)明Tag2IntegerMServiceID標(biāo)簽值Length2IntegerValue部分的長(zhǎng)度Value21OctetString業(yè)務(wù)代碼。用于移動(dòng)網(wǎng)業(yè)務(wù)。要求填寫產(chǎn)品ID(Productid,PID)。Serviceid和Productid是包含關(guān)系,一個(gè)Serviceid可以有多個(gè)Productid,電信僅向CP/SP開放Productid,Serviceid用于內(nèi)部管理使用,Serviceid不開放給CP/SP使用。目前SMGW和CP/SP的SMGP接口只有Serviceid字段而沒有productid字段,為繼承以前版本,要求CP/SP在和引擎接口的Serviceid字段里填寫Productid內(nèi)容,引擎透?jìng)鞔藘?nèi)容到ISMAP接口的PID字段里,ISMP獲取到的是Productid內(nèi)容。基于SMGP協(xié)議的API函數(shù)詳見附錄A。附錄A基于SMGP協(xié)議的API函數(shù)說(shuō)明(規(guī)范性附錄)A.1基本要求A.1.1安裝網(wǎng)關(guān)需要提供API軟件包,解壓到指定目錄下后可以修改配置文件,配置參數(shù)至少包括SPId(SP編號(hào))、SPShareKey(SP密碼)、ClientIP(客戶主機(jī)的IP地址)和ServerIP(短消息網(wǎng)關(guān)地址)。A.1.2例子程序網(wǎng)關(guān)至少應(yīng)該提供以下例程,供SP調(diào)試使用,分別為:Connect(參數(shù)),檢查是否能夠成功登錄短消息網(wǎng)關(guān);TestAPI(參數(shù)),檢查是否能夠成功連接短消息網(wǎng)關(guān)。SetKey(參數(shù)),修改SP密碼。SendSM(參數(shù))嘗試發(fā)送短消息。RecvSM(參數(shù))嘗試接收短消息等。RecvSMReport(參數(shù)),嘗試接收短消息狀態(tài)報(bào)告。A.1.3操作系統(tǒng)平臺(tái)要求網(wǎng)關(guān)提供的API軟件包至少要求支持以下操作系統(tǒng)平臺(tái):FreeBSD3.x,4.2Solaris5.6,5.7,5.8(包含x86)Linux(Redhat和Slack等主流產(chǎn)品)WindowsNT/2000等網(wǎng)關(guān)提供的API軟件包至少要求支持以下編程語(yǔ)言:C/C++JAVAA.2API數(shù)據(jù)結(jié)構(gòu)說(shuō)明(以C語(yǔ)言為例)A.2.1接收短消息的返回?cái)?shù)據(jù)結(jié)構(gòu)(DeliverResp)用途保存SMGPDeliver函數(shù)返回的短消息內(nèi)容。字段說(shuō)明字段名數(shù)據(jù)類型說(shuō)明SMsgIDChar(21)短消息標(biāo)識(shí)NMsgFormatInt短消息格式(參照短消息格式代碼表)。網(wǎng)關(guān)不做判定,透明傳輸。SSrcTermIDChar(22)短消息發(fā)送用戶號(hào)碼NIsReportInt是否為狀態(tài)報(bào)告。代碼含義:非狀態(tài)報(bào)告(0);狀態(tài)報(bào)告(1)NMsgLenInt消息長(zhǎng)度sMsgContentChar(253)消息內(nèi)容sDestTermIDChar(22)SP的接入代碼sRecvTimechar(15)短消息接收時(shí)間(格式:yyyymmddhhmiss,例如20010301200000)sReservedChar(9)保留A.2.2獲取群發(fā)短消息的返回?cái)?shù)據(jù)結(jié)構(gòu)(SendBatchResp)用途使用SMGPSendBatch群發(fā)短消息后,每條短消息的“消息標(biāo)識(shí)”和“錯(cuò)誤代碼”保存在文件里。SMGPAPI提供GetSendBatchResp函數(shù)獲取每一條短消息返回信息,保存在SendBatchResp中。字段說(shuō)明字段名數(shù)據(jù)類型說(shuō)明sMsgIDChar(21)短消息標(biāo)識(shí)nErrorCodeInt錯(cuò)誤代碼(參照錯(cuò)誤代碼表)sPhoneNoChar(22)發(fā)送號(hào)碼A.2.3查詢短消息網(wǎng)關(guān)的返回?cái)?shù)據(jù)結(jié)構(gòu)(QueryResp可選)用途保存SMGPQuery函數(shù)返回的查詢結(jié)果。字段說(shuō)明字段名數(shù)據(jù)類型說(shuō)明nMT_TLMsgInt接收短消息總數(shù)nMT_TLusrInt接收用戶總數(shù)nMT_ScsInt成功轉(zhuǎn)發(fā)數(shù)量nMT_WTInt待轉(zhuǎn)發(fā)數(shù)量nMT_FLInt轉(zhuǎn)發(fā)失敗數(shù)量nMO_ScsInt成功送達(dá)數(shù)量nMO_WTInt待送達(dá)數(shù)量nMO_FLInt送達(dá)失敗數(shù)量A.3API函數(shù)說(shuō)明A.3.1初始化API(InitSMGPAPI)作用初始化SMGPAPI,應(yīng)用程序只需要調(diào)用一次此函數(shù)。參數(shù)參數(shù)名數(shù)據(jù)類型說(shuō)明SiniFileChar(100)SMGPAPI配置文件名,缺省值是:”../config/smgpc.ini”。如果應(yīng)用程序的執(zhí)行目錄不在smgpapi/bin下,就需要通過(guò)絕對(duì)或相對(duì)路徑指定sINIFile。例如:InitSMGPAPI(“/opt/smgpapi/config/smgpc.ini”)返回0=成功1=失敗A.3.2發(fā)送單條短消息(SMGPSendSingle)作用向短消息網(wǎng)關(guān)發(fā)送1條短消息到1個(gè)終端用戶。短消息長(zhǎng)度最長(zhǎng)為200,SMGPAPI在發(fā)送時(shí)自動(dòng)建立ConnectionPool,采用長(zhǎng)連接或者短連接發(fā)送短消息。當(dāng)Cache的connection中斷時(shí),API能夠自動(dòng)重新連接短消息網(wǎng)關(guān)。如果應(yīng)用程序采用多線程發(fā)送短消息,多個(gè)線程共享同一個(gè)ConnectionPool。在發(fā)送過(guò)程中,如果因?yàn)橥ㄐ旁驅(qū)е掳l(fā)送失敗,API能夠自動(dòng)重新發(fā)送,重試的次數(shù)在配置文件設(shè)置。參數(shù)參數(shù)名數(shù)據(jù)類型說(shuō)明nNeedReportInt是否要求返回狀態(tài)報(bào)告(0=不要求,1=要求)nMsgLevelInt信息級(jí)別(0-9,0=最低優(yōu)先級(jí))sServiceIDChar(11)業(yè)務(wù)代碼nMsgFormatInt短消息格式(參照短消息格式表)。網(wǎng)關(guān)不做判定,透明傳輸。sFeeTypeChar(3)資費(fèi)類別sFeeCodeChar(7)資費(fèi)代碼(以分為單位)sFixedfeeChar(7)包月費(fèi)/封頂費(fèi)(以分為單位)sValidTimeChar(18)存活有效期,格式遵循SMPP3.3協(xié)議sAtTimeChar(18)定時(shí)發(fā)送時(shí)間,格式遵循SMPP3.3協(xié)議sSrcTermIdChar(22)發(fā)送號(hào)碼sChargeTermIDChar(22)計(jì)費(fèi)號(hào)碼sDestTermIDChar(22)短消息接收號(hào)碼nMsgLenInt短消息長(zhǎng)度sMsgContentChar(*)短消息內(nèi)容(nMsgLen=0時(shí)表示存放短消息的文件名)sMsgIDChar(11)返回的短消息標(biāo)識(shí)nErrorCodeInt*錯(cuò)誤代碼(參照錯(cuò)誤代碼表)。sMsgTypeChar(2)短消息類型sReservedChar(9)保留返回0=成功1=失敗A.3.3群發(fā)短消息(SMGPSendBatch)作用向短消息網(wǎng)關(guān)發(fā)送1條短消息到多個(gè)終端用戶。短消息長(zhǎng)度最長(zhǎng)為200,此函數(shù)使用文件傳遞短消息內(nèi)容。SMGPAPI在發(fā)送時(shí)自動(dòng)建立ConnectionPool,采用長(zhǎng)連接或者短連接發(fā)送短消息。當(dāng)Cache的connection中斷時(shí),API能夠自動(dòng)重新連接短消息網(wǎng)關(guān)。如果應(yīng)用程序采用多線程發(fā)送短消息,多個(gè)線程共享同一個(gè)ConnectionPool。在發(fā)送過(guò)程中,如果因?yàn)橥ㄐ旁驅(qū)е掳l(fā)送失敗,API能夠自動(dòng)重新發(fā)送,重試的次數(shù)在配置文件設(shè)置。參數(shù)參數(shù)名數(shù)據(jù)類型說(shuō)明nNeedReportInt是否要求返回狀態(tài)報(bào)告(0=不要求,1=要求)nMsgLevelInt優(yōu)先級(jí)別,(0-9,0表示最低優(yōu)先級(jí))sServiceIDChar(11)業(yè)務(wù)代碼nMsgFormatInt短消息格式(參照短消息格式表)。網(wǎng)關(guān)不做判定,透明傳輸。sFeeTypeChar(3)資費(fèi)類別sFeeCodeChar(7)資費(fèi)代碼(以分為單位)sFixedfeeChar(7)包月費(fèi)/封頂費(fèi)(以分為單位)sValidTimeChar(18)存活有效期,格式遵循SMPP3.3協(xié)議sAtTimeChar(18)定時(shí)發(fā)送時(shí)間,格式遵循SMPP3.3協(xié)議sSrcTermIDChar(22)短消息發(fā)送用戶號(hào)碼(當(dāng)為SP代碼時(shí)須在前面加118)sChargeTermIDChar(22)計(jì)費(fèi)號(hào)碼(若為空,則對(duì)被叫計(jì)費(fèi))sDestTermIDFileChar(100)保存所有目的號(hào)碼的文件名

溫馨提示

  • 1. 本站所有資源如無(wú)特殊說(shuō)明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁(yè)內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。

最新文檔

評(píng)論

0/150

提交評(píng)論