電信移動終端需求-4g數(shù)據(jù)終端接口協(xié)議分冊

1、等 級： 5 年中國電信公司企業(yè)標(biāo)準(zhǔn)Q/CTX-20132013-08-發(fā)布2013-08-實施中國電信公司發(fā) 布中國電信移動終端需求規(guī)范4G 數(shù)據(jù)終端接口協(xié)議分冊（V2013）Requirement Specifications for Mobile Terminal of China-4G Daerminal Protocol Fascicule（Ver2013）YD/T 2013目錄前言41適用范圍42參考資料53縮略語54總體技術(shù)要求64.1 協(xié)議.24.1.3RESTFul 簡介6安全驗證7接口格式介紹74.2 驅(qū)動要求84.3URI 規(guī)則84.4 異常/錯誤處理9

2、4.5 字段命名規(guī)則114.6 不支持字段處理114.7 字段類型說明125具體接口描述12 12查詢 Pin 碼狀態(tài)12開啟 Pin 碼13禁用 Pin 碼13修改 Pin 碼14Pin 碼14PUK 碼.. 狀態(tài)監(jiān)測.2查詢網(wǎng)絡(luò)狀態(tài)信息15查詢新消息185.3 設(shè)備功能..45.3.5查詢 device information18恢復(fù)出廠設(shè)置20固件升級檢查20固件升級啟動接口20固件升級狀態(tài)接口202YD/T 20135.4 網(wǎng)絡(luò).2連接網(wǎng)

3、絡(luò)21斷開網(wǎng)絡(luò)225.5 NET 功能.......9查詢 Network22設(shè)置 Network22獲取 PLMN 列表23獲取當(dāng)前網(wǎng)絡(luò)信息24獲取自動和手動設(shè)置自動和手動網(wǎng)絡(luò)24網(wǎng)絡(luò)25（可選）25設(shè)置未讀為已讀25查詢查詢數(shù)量26列表26 29發(fā)送狀態(tài)29 30 30配置31配置32獲取刪除查詢設(shè)置6詳細(xì)更新歷史323YD/T 2013本標(biāo)準(zhǔn)按照GB/T 1.1-2009給出的規(guī)則起草。標(biāo)準(zhǔn)電信移動終端需求體系的系列規(guī)范標(biāo)準(zhǔn)之一，中國電信移動終端

4、需求規(guī)范標(biāo)準(zhǔn)體系主要包括但不限于以下分冊：1)2)3)4)5)6)7)8)9)10)11)12)13)14)15)16)17)18)19)20)中國電信移動終端需求規(guī)范-基本技術(shù)要求分冊中國電信移動終端需求規(guī)范-SMS 分冊中國電信移動終端需求規(guī)范-MMS 分冊中國電信移動終端需求規(guī)范-瀏覽器分冊中國電信移動終端需求規(guī)范-CDMA_GSM 雙模終端分冊中國電信移動終端需求規(guī)范-現(xiàn)網(wǎng)分冊中國電信移動終端需求規(guī)范-LBS 分冊中國電信移動終端需求規(guī)范-流分冊中國電信移動終端需求規(guī)范-DM 分冊中國電信移動終端需求規(guī)范-分冊中國電信移動終端需求規(guī)范-CDMA+WiFi 分冊中國電信移動終端需求規(guī)范-

5、QChat 分冊中國電信移動終端需求規(guī)范-QChat 業(yè)務(wù) UI 分冊中國電信移動終端需求規(guī)范-PSVT 分冊中國電信移動終端需求規(guī)范-Rev.A 數(shù)據(jù)終端技術(shù)要求分冊中國電信移動終端需求規(guī)范-Java 分冊中國電信移動終端需求規(guī)范-BREW 分冊中國電信移動終端需求規(guī)范-1xEVDO RevB 技術(shù)要求分冊中國電信移動終端需求規(guī)范-UI 分冊中國電信移動終端需求規(guī)范-4G 接口協(xié)議分冊該系列規(guī)范標(biāo)準(zhǔn)主要依據(jù)中國電信企業(yè)標(biāo)準(zhǔn)中的相關(guān)規(guī)定和中國電信移動終端需求，并結(jié)合3GPP2、3GPP、CDG國際標(biāo)準(zhǔn)，以及CCSA行業(yè)標(biāo)準(zhǔn)編寫，對的要求。X等方面提出了具體本由中國電信公司提出并歸口。本標(biāo)準(zhǔn)起草

6、：本標(biāo)準(zhǔn)由中國電信起草。公司公眾客戶事業(yè)部組織制定，中國電信標(biāo)準(zhǔn)主要起草人：艾水根、本標(biāo)準(zhǔn)于 2013 年 XX 月首次發(fā)布。、。1 適用范圍電信（簡稱中國電信）4G 數(shù)據(jù)終端客戶端采用的 Web Service 接口協(xié)議提出規(guī)定，中國電信和廠商共同使用，用于在業(yè)務(wù)及設(shè)備開發(fā)上為公司和省公司提供技術(shù)依據(jù)；適用于以數(shù)據(jù)卡形式的移4前言YD/T 2013動終端產(chǎn)品。2 參考資料下列標(biāo)準(zhǔn)所包含的條文，通過在中而為的條文。凡是注日期的標(biāo)準(zhǔn)，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于，若其被修訂，使用的各方應(yīng)探討使用其版本的可能性。凡是不注日期的標(biāo)準(zhǔn)，其版本適用于。1.ETSI GSM07

7、.072.ETSI GSM07.073.TIA-EIA-IS-707-A.34.ITU-TmendationV.25ter143縮略語5Abbreviations縮略語Full spelling 英文全名Chiexplanation 中文解釋3GPPThird Generation Partnership Project第三代伙伴計劃BERBit error rate誤碼率CDMACode DiviMultiple Acs碼分多址CLIPCall Line Identifier presenion呼叫號碼顯示DCEDircuit Equipment數(shù)據(jù)電路設(shè)備Doding scheme數(shù)據(jù)編碼

8、方案DTEDaerminal Equipment數(shù)據(jù)終端設(shè)備EVDOEvolution Data Only演進版本，僅支持?jǐn)?shù)據(jù)GPRSGeneral Packet Radio Service通用分組無線系統(tǒng)GSMGlobal System for Mobile Communications全球移動通信IMEIernational Mobile Equipment Identity國際移動設(shè)備標(biāo)識ITU-Ternationalmunicationmunication Standardization Sector國際電信-電信標(biāo)準(zhǔn)部YD/T20134總體技術(shù)要求4.1 協(xié)議為了便于推廣，此接口遵循

9、業(yè)界 Web Service 主流接口風(fēng)格 RESTful。全文所有協(xié)議接口數(shù)據(jù)使用 UTF-8 編碼。4.1.1 RESTFul簡介REST 從資源的角度來觀察整個網(wǎng)絡(luò)，分布在各處的資源由 URI 確定，而客戶端的應(yīng)用通過 URI 來獲取資源的表形。獲得這些表形致使這些應(yīng)用程序轉(zhuǎn)變了其狀態(tài)。隨著不斷獲取資源的表形，客戶端應(yīng)用不斷地在轉(zhuǎn)變著其狀態(tài)，所謂表形化的狀態(tài)轉(zhuǎn)變（Represenional Se Transfer）。需要注意的是，REST 是一種設(shè)計風(fēng)格而不是一個標(biāo)準(zhǔn)。REST 通?；谑褂?Abbreviations縮略語Full spelling 英文全名Chiexplanation

10、 中文解釋IWFerworking Function網(wǎng)絡(luò)互通功能單元MTMobile Terminal移動終端PDPPacket Data Protocol包交換協(xié)議PINal Identity Number個人識別碼PLMNPublic land mobile network公用陸地移動網(wǎng)絡(luò)PUKal Identity Number個人標(biāo)識碼RPLMNRegistered PLMNPLMNRSSIReceive signal strength indicator接收信號強度指示SCASevice Center Address服務(wù)中心號碼SIMGSM Subscriber Identity M

11、odule用戶標(biāo)識組件SMShort messageTETerminal Equipment終端設(shè)備，這里指在 PC 上運行的統(tǒng)一終端客戶端UIMUser Identity Module用戶標(biāo)識模塊URCUnsolicited result code主動上報結(jié)果碼，如上報、上報、狀態(tài)改變上報等。USIMUniversal Subscriber Identity Module用戶業(yè)務(wù)標(biāo)識組件WCDMAWideband CDMA寬帶碼分多址YD/T 2013HTTP，URI，和 XML 以及 HTML 這些現(xiàn)有的廣泛流行的協(xié)議和標(biāo)準(zhǔn)。資源是由 URI 來指定。對資源的操作包括獲取、創(chuàng)建、修改和刪除

12、資源，這些操作正好對應(yīng) HTTP協(xié)議提供的 GET、T、PUT 和 DELETE 方法。通過操作資源的表形來操作資源。資源的表現(xiàn)形式則是 XML 或者 HTML，取決于讀者是機器還是人，是消費 web服務(wù)的客戶還是 web 瀏覽器。當(dāng)然也可以是任何其他的格式。4.1.2 安全驗證客戶端約定增加終端標(biāo)志，標(biāo)志為：CWCnt在 HTTP 請求的 HEADER 中增加 2 個字段，分別為 sign 和 time，sign 按照以下規(guī)則組合：將組合字段拼接后 MD5 加密，產(chǎn)生的值作為 sign 鍵的值。例如：time 為 1377166687，所以 sign 值為：CWCnt&1377166687

13、組合后進行MD5 加密，產(chǎn)生鍵值 sign 內(nèi)容為 00b8309dcc3692dad0f786668dc15b75,然后將time 和 sign 加入 HTTP 請求 HEADER 中，所增加的 HTTP 頭：time=“1377166687”sign=“00b8309dcc3692dad0f786668dc15b75”。WebServer 收到請求后使用約定的關(guān)鍵字 CWCnt+&+HTTP 頭所帶的 time進行 MD5 加密，如果加密后的數(shù)據(jù)與 HTTP 頭中的 sign 相同則認(rèn)為是合法的請求，需要正常響應(yīng)，否則不作響應(yīng)。4.1.3 接口格式介紹例 1：查詢 PIN 碼狀態(tài)，根據(jù) R

14、estful 風(fēng)格，可以認(rèn)為是獲取 PIN 碼狀態(tài)這個資源：HTTP 方法：GETURI：api/pin/satus資源的表現(xiàn)形式：XML7組合字段客戶端標(biāo)志&time約定值CWCnt&timeYD/T 2013所以查詢 PIN 碼狀態(tài)請求的報文如下：GET api/pin/sus HTTP/1.1查詢 PIN 碼狀態(tài)響應(yīng)的報文如下：例 2：模式切換，根據(jù) Restful 風(fēng)格，可以認(rèn)為是設(shè)置設(shè)備模式這個資源：HTTP 方法：TURI：aevicemode資源的表現(xiàn)形式：XML模式切換請求的報文如下：模式切換響應(yīng)的報文如下：4.2 驅(qū)動要求數(shù)據(jù)卡需要支持 XP 以上系統(tǒng)免驅(qū)動安裝，數(shù)據(jù)卡，系統(tǒng)

15、能自動識別并安裝驅(qū)動，驅(qū)動安裝后可使用客戶端進行使用。驅(qū)動支持 Mac OSX 10.6 以上系統(tǒng)。數(shù)據(jù)卡后，需要自動識別檢測是否有安裝 PC 客戶端，如果有安裝就自動啟動 PC 客戶端，如果沒有安裝則提示用戶安裝?？蛻舳艘髮崿F(xiàn)固件升級功能，調(diào)用設(shè)備接口實現(xiàn)。4.3URI 規(guī)則URI 是網(wǎng)絡(luò)上用戶可和使用的各種資源的標(biāo)識。終端設(shè)備的 Pin 碼、運8 0接口地址規(guī)定：T a evicemode HTTP/1.11ErrorCode 正確不需要返回，如果錯誤返回YD/T 2013營商信息、模式、等都可以認(rèn)為是終端設(shè)備上可供用戶和使用的資源，這些資源都用唯一的 URI 進行標(biāo)識，規(guī)則如下：Web

16、 Service 接口，按照下面的形式提供：api/category/function/sub_function/用“/”來標(biāo)識資源之間的層次關(guān)系，如“/aaa/bbb”，表示“aaa”是“bbb”的上層資源，通常有“aaa”包含“bbb”的關(guān)系。Api：在該文檔中所有的資源都在包含在“api”這個節(jié)點內(nèi)，即所有的資源都以“api”開頭。Category：資源按功能進行分類，如 pin 碼相關(guān)功能對應(yīng) api/pin，狀態(tài)監(jiān)測相關(guān)功能對應(yīng) api/monitoring，模式切換功能對應(yīng) aevicemode 等；function：function 是 category 標(biāo)識的功能分類下的一個子

17、節(jié)點，如 pin功能分類里的 pin 碼狀態(tài)這個子節(jié)點，URI 為 api/pin/sus，特殊功能組里的特殊條數(shù)則是 api/spelsms/count；function 下還有可以有多層sub_function。URI 全用小寫字母，可用“-”來增強可讀性。如 restore-factory-settings，表示恢復(fù)出廠設(shè)置。4.4 異常/錯誤處理所有請求，如果在 web server 端執(zhí)行出現(xiàn)異?；蝈e誤，返回錯誤碼，用于網(wǎng)頁進行錯誤處理和錯誤信息提示。Error Code 表9ErrorCodeError CodeCategoryDescription0成功100001通用錯誤未知e

18、rror類型。100002不支持該請求。100003系統(tǒng)忙，暫時無法處理該請求100004請求格式錯誤。字段名類型長度說明responseeger6ErrorCode錯誤碼見error code表。YD/T201310Error CodeCategoryDescription100005參數(shù)錯誤100006保存配置文件錯誤100007通用錯取配置文件節(jié)點錯誤101001Pin碼1、沒有2、了無效的101002檢測到Pin碼鎖定101003檢測到puk碼鎖定101004檢測到不可用101005啟用Pin碼失敗101006禁用Pin碼失敗101007Pin碼失敗101008pin碼校驗失敗1010

19、09修改pin碼失敗101010puk碼校驗失敗102001狀態(tài)監(jiān)測獲取網(wǎng)絡(luò)類型失敗102002獲取服務(wù)狀態(tài)失敗102003獲取漫游狀態(tài)失敗102004獲取連接狀態(tài)失敗103001DIALUP(可選)獲取連接配置文件設(shè)置錯誤103002設(shè)置連接配置文件設(shè)置錯誤103004撥號管理錯誤103005增加Profile錯誤103006修改Profile錯誤103007刪除Profile錯誤103008設(shè)置默認(rèn)Profile錯誤103009獲得Profile列表錯誤103010獲得auto APN匹配錯誤103011設(shè)置auto APN匹配錯誤104001NET撥號情況下設(shè)置網(wǎng)絡(luò)模式或頻段失敗1040

20、02撥號情況下設(shè)置搜網(wǎng)模式失敗104003網(wǎng)絡(luò)模式和頻段設(shè)置失敗104004設(shè)置搜網(wǎng)模式失敗104005網(wǎng)絡(luò)失敗104006網(wǎng)絡(luò)接入次序不匹配104007當(dāng)前設(shè)置的網(wǎng)絡(luò)制式不支持104008當(dāng)前不在準(zhǔn)備好的狀態(tài)104009內(nèi)存分配失敗105001SMS（可選）入?yún)榭?數(shù)據(jù)105002超時105003查詢索引列表錯誤105004設(shè)置中心號碼失敗105005刪除失敗YD/T 20134.5 字段命名規(guī)則字段名采用駝峰命名法，每個單詞以大寫字母開始，單詞之間不間隔。如，Nessword。表示數(shù)組的字段后加 S 表示復(fù)數(shù)，如，F(xiàn)ilters。4.6 不支持字段處理不支持的字段可以有兩種方式處理。節(jié)點

21、保留，只需要節(jié)點內(nèi)容為空。客戶端和 WebServer 端對為空的字段不進行處理。如 A 產(chǎn)品支持 Pin 碼查詢請求，但不支持獲取剩余輸入 pin 碼次數(shù)，則該字段內(nèi)容為空即可。見下：發(fā)送報文：GET api/pin/sus HTTP/1.1返回報文：整個節(jié)點不保留。PC 客戶端和 WebServer 端不出現(xiàn)的字段不進行處理。如 A產(chǎn)品支持 Pin 碼查詢請求，但不支持獲取剩余輸入 pin 碼次數(shù)，則該字段不出現(xiàn)。見下：發(fā)送報文：GET api/pin/sus HTTP/1.1返回報文：112572583Error CodeCategoryDescription105006SMS（可選）保

22、存配置文件錯誤105007本地空間105008號碼超長105009PB（可選）入?yún)榭?數(shù)據(jù)105010超時105011調(diào)用系統(tǒng)函數(shù)出錯105012文件寫入失敗105013文件失敗105014本地本已滿YD/T20134.7 字段類型說明字段類型說明如下：根據(jù)目前的需求，僅僅eger 和 string 兩個類型就可以滿足要求，但為了后續(xù)的擴展性，也定義了二進制和結(jié)構(gòu)體類型進行約定。5 具體接口描述 查詢Pin碼狀態(tài)請求：GET api/pin/sus HTTP/1.1響應(yīng)：12字段名類型長度說明M/OSimSeeger1狀態(tài)。0:no sim card or invalid c

23、ard 1:SIM ready2:PIN required 3:PUK requiredMSimPimeseger1剩余輸入Pin碼次數(shù)。 0-3MSimPukTimeseger2剩余輸入PUK碼次數(shù)。 0-10M字段類型類型說明eger十進制整型數(shù)string字符串binary由byte組成的字符串，由于XML不能直接承載二進制數(shù)據(jù)，所以對該類型的數(shù)據(jù)采用BASE64 編碼；_scheme結(jié)構(gòu)體類型2572583YD/T20135.1.2 開啟Pin碼請求：響應(yīng)：5.1.3 禁用Pin碼請求：響應(yīng)：r13字段名類型長度說明M/Oesponseeger6ErrorCodeM ErrorCode

24、字段名類型長度說明M/OCurrentPinString8輸入的Pin碼，4-8 位數(shù)字。MT api/pin/disable HTTP/1.1123456字段名類型長度說明M/Oresponseeger6ErrorCodeM ErrorCode字段名類型長度說明M/OCurrentPinstring8輸入的Pin碼，4-8 位數(shù)字。MT api/pin/enable HTTP/1.11234561310YD/T20135.1.4 修改Pin碼請求：響應(yīng)：5.1.5Pin碼請求：響應(yīng)：5.1.6PUK碼請求：14字段名類型長度說明M/OPukNumberstring8輸入PUK碼，8 位數(shù)字。

25、MNewPinString8輸入新的PIN碼，4-8 位數(shù)字MT api/pin/entuk HTTP/1.1字段名類型長度說明M/Oresponseeger6ErrorCodeMErrorCode字段名類型長度說明M/OCurrentPinstring8輸入舊的Pin碼，4-8 位數(shù)字。MT api/pin/entin HTTP/1.1123456字段名類型長度說明M/Oresponse6ErrorCodeM ErrorCode字段名類型長度說明M/OCurrentPinString8輸入舊的Pin碼，4-8 位數(shù)字。MNewPinString8輸入新的Pin碼，4-8 位數(shù)字。MT api

26、/p odify HTTP/1.1123456654321YD/T2013響應(yīng)：5.2 狀態(tài)監(jiān)測5.2.1 查詢網(wǎng)絡(luò)狀態(tài)信息請求：GET api/monitoring/sus HTTP/1.1響應(yīng)：15字段名類型長度說明M/OConnectionSuseger4當(dāng)前連接狀態(tài)。取值范圍：0,999(待確認(rèn))2: IMSI unknown in HLR 3: Illega5: Illegal ME7: GPRS servinot allowed 8: Operator Determined Barring9: MS identity cannot be derived by the network

27、10: Implicitly detached 11: PLMN not allowed12: Location Area not allowed13: Roaming not allowedhis location area14: GPRS servinot allowedhis PLMN15: No Suitable Cells In Location Area 16: MSC temporarily not reachable17: Network failure20: MAC failure21: Synch failure22: Congestion23: GSM authentic

28、ation unacceptable 25: LLC or SNDCP failure(GSM only)M字段名類型長度說明M/Oresponsestring6ErrorCodeMErrorCode12345678654321YD/T20131626: Insufficient resour 27: Missing or unknown APN28: Unknown PDP address or PDP type 29: User Authentication failed30: Activation rejected by GGSN31: Activation rejected, unsp

29、ecified 32: Service option not supported33: Requested service option not subscribed34: Service option temporarily out of order35: NSAPI already used (not) 36: Regular deactivation37: QoS not accepted 38: Network failure39: Reactivation required 40: Feature not supported41: Semerrorhe TFT operation 4

30、2: Syntactical errorhe TFT operation43: Unknown PDP context44: Semerrors in packet filter(s) 45: Syntactical errors in packet filter(s)46: PDP context without TFT already activated48:retry upon entryo a new cell (4863)81: Invalid tranion identifier value95: Semally incorrect message 96: Invalid mand

31、atory information 97: Message type non-existent or not implemented98: Message type not compatible with the protocol se99: Information element non-existent or not implemented100: Conditionaerror101: Message not compatible with the protocol se111: Protocol error, unspecified 900：連接中901：已連接YD/T20131790

32、2：已斷開903：斷開中904：連接失敗以上連接狀態(tài)的描述不直接作為給用戶的提示。RoamingSuseger1漫游狀態(tài)。0,1（0 非漫游，1 國內(nèi)漫游）MWanIPAddressstring16網(wǎng)關(guān)ip地址。取值范圍：如 OWanIPv6Addressstring128網(wǎng)關(guān)ipv6 地址。取值范圍：如:x 或者 0OPrimaryDnsstring16主dns的IP地址。取值范圍：如MPrimaryIPv6Dnsstring128主dns的IPv6 地址。取值范圍：如:x 或者 0, 0 表示沒有使用 IPv6OSecondaryDnsstring16次dns的IP地址。取值范圍：OSec

33、ondaryIPv6Dnsstring128次dns的IPv6 地址。取值范圍：:x 或者 0，0 表示沒有使用 IPv6OServiuseger1系統(tǒng)服務(wù)狀態(tài)0：無服務(wù)1：有限務(wù)2：服務(wù)有效M901754231-1275055334425522551232900YD/T 20135.2.2 查詢新消息請求：GET api/monitoring/checknews HTTP/1.1該命令提供給PC 客戶端定時查詢是否有新消息需要即時處理,如果sms 模塊有新消息來, PC 客戶端需要另外調(diào)用 restful 接口去獲取未讀條數(shù)，并在頁面上提示用戶有未讀條數(shù)。響應(yīng)：5.3 設(shè)備功能5.3.1 查

34、詢deviceinformation請求：GET aevice/information HTTP/1.1響應(yīng)：18字段名類型長度說明M/ODeviceNamestring32產(chǎn)品型號。MSerialNumberstring32序列號。MImeistring32IMEI號MImsistring32IMSI號M字段名類型長度說明NewsTypeString4【1000 - 1999】:SMS 1001 新1002滿1003 設(shè)備滿1000200140YD/T201319Iccidstring32唯一標(biāo)識MMsisdnstring32本機號碼OHardwareVerstring32硬件版本MSoft

35、wareVerstring32版本MMacAddress1string32MAC地址MClassifystring32設(shè)備終端類型1、 常規(guī)數(shù)據(jù)卡；2、 具有WiFi功能的數(shù)據(jù)卡；3、MiFi終端；4、 cpe 表示 CPE 產(chǎn)品類型;OMeidstring32MEID號OPrlVerstring32PRL版本號Osupportmodestring32當(dāng)前的設(shè)備支持的制式取值為下面中的一項或多項組合：八位組定義M87654321GS MWC DM ACD MAFD DTD Dworkmodestring32當(dāng)前工作的模式取值為下面中的某一項：參照supportmodeME5830SA00000

36、0000035010000000000460080000000241131313131313WLAGCPU996.11.00.01.1001.300:1E:10:0E:22:3300:1E:10:0E:22:44WCDMAhilink80761abda5870900000000033071supportm TE|WCDMAworkmTEYD/T 20135.3.2 恢復(fù)出廠設(shè)置請求：GET aevice/ restore-factory-settings HTTP/1.1響應(yīng)：5.3.3 固件升級檢查請求：GET aevice/updatecheck HTTP/1.1響應(yīng)：5.3.4固件升級啟

37、動接口請求：T aevice/update HTTP/1.1響應(yīng)：5.3.5固件升級狀態(tài)接口請求：GET aevice/updatese HTTP/1.1響應(yīng)：20字段名類型長度說明M/OSeeger4狀態(tài)編碼【30003999】: online-updateM字段名類型長度說明M/Oresponseeger6ErrorCodeMErrorCode字段名類型長度說明M/OUpdateSeeger4Update se 0 無新版本1 有新版本MVerString32verM字段名類型長度說明M/Oresponsestring6ErrorCodeMErrorCodeYD/T20135.4 網(wǎng)絡(luò)數(shù)據(jù)

38、卡需要有客戶端才能進行連接，數(shù)據(jù)卡本身不作自動連接處理5.4.1連接網(wǎng)絡(luò)請求:響應(yīng)：21ErrorCode字段名類型長度說明M/Oresponseeger6ErrorCodeM字段名類型長度說明M/Otring32Apn nameMUserNameString64User nameMPasswordString64passwordMT aialup/dial HTTP/1.13010:狀態(tài)，無操作；3011：正在連接服務(wù)器3012 連接成功3013 連接失敗3014：正在升級包3015：失敗3016：完成3017 升級包校驗失敗3018 升級包校驗成功3019 升級成功3020 升級失敗302

39、1：臨時狀態(tài)。表示重啟后發(fā)現(xiàn)上次未完成，需用戶確認(rèn)。一旦用戶確認(rèn)，立即切換到Downlorogressing狀態(tài)YD/T 20135.4.2 斷開網(wǎng)絡(luò)請求：T aialup/hangup HTTP/1.1響應(yīng)：5.5 Net 功能5.5.1 查詢Network請求：GET api/net/network HTTP/1.1響應(yīng)：5.5.2設(shè)置Network請求：字段名類型長度說明M/ONetworkModestring1網(wǎng)絡(luò)模式：重定義0：Auto(4G Pre，TDD優(yōu)先)M1：2G2：3Gonlyonly3：4G only(TDD優(yōu)先)NetworkNumberstring846003MCC

40、MNCMT api/net/network HTTP/1.122ErrorCode字段名類型長度說明M/ONetworkModestring32網(wǎng)絡(luò)模式： 0：Auto(4G Pre) 1：2G only 2：3G only 3：4G onlyMSignalBarstring40,5O05字段名類型長度說明M/Oresponseeger6ErrorCodeMYD/T 201346003響應(yīng)：5.5.3 獲取PLMN列表請求：GET api/net/plmn-list HTTP/1.1響應(yīng)：23字段名類型長度說明M/OIndexeger4網(wǎng)絡(luò)索引MSeeger4網(wǎng)絡(luò)的狀態(tài)標(biāo)識：0：未知的1：可用

41、的2：當(dāng)前3：MFullNamestring128運營商全名(該字段有可能為空)MShortNamestring128運營商短名(該字段有可能為空)MNumericstring16網(wǎng)絡(luò)的數(shù)字名，當(dāng)前為 5-7 位數(shù)字字符串MRateger1無線接入技術(shù)：0：2G1：3G2：4GM10china mobilechina mobile46009220china mobilechina mobile460090字段名類型長度說明M/Oresponseeger6ErrorCodeMErrorCode0YD/T 20135.5.4 獲取當(dāng)前網(wǎng)絡(luò)信息請求：GET api/net/current-plmn

42、HTTP/1.1響應(yīng)：5.5.5獲取自動和手動網(wǎng)絡(luò)請求：24GET api/net/register HTTP/1.1字段名類型長度說明M/OModeeger4網(wǎng)絡(luò)選擇模式0：自動搜網(wǎng)1：手動搜網(wǎng)MPlmnstring16運營商數(shù)字名，需要攜帶PLMNORateger4無線接入技術(shù)：0：2G1：3G2：4GO字段名類型長度說明M/OSeeger4網(wǎng)絡(luò)選擇模式：0：自動搜網(wǎng)1：手動搜網(wǎng)2：去網(wǎng)絡(luò)3：僅讀命令設(shè)置返回運營商格式4：手動搜網(wǎng)與自動搜網(wǎng)的聯(lián)合，如果手動搜網(wǎng)失敗，則自動轉(zhuǎn)入自動搜網(wǎng)MFullNamestring128運營商全名(該字段有可能為空)MShortNamestring128運營

43、商短名(該字段有可能為空)MNumericstring16網(wǎng)絡(luò)的數(shù)字名，為 5-7 位數(shù)字字符串MRateger1無線接入技術(shù)：0：2G1：3G2：4GM0460012YD/T2013響應(yīng)：5.5.6 設(shè)置自動和手動網(wǎng)絡(luò)請求（字段表參考獲取自動和手動網(wǎng)絡(luò)）：響應(yīng)：5.6（可選）5.6.1設(shè)置未讀為已讀請求：響應(yīng)：25字段名類型長度說明M/Oresponseeger6ErrorCodeMErrorCode字段名類型長度說明M/OIndexeger8索引，和本地Index不重復(fù)MT api/sms/set-read HTTP/1.140001400024000340004字段名類型長度說明M/Or

44、esponseeger6ErrorCodeMErrorCodeT api/net/register HTTP/1.104600920460092YD/T 20135.6.2 查詢數(shù)量請求：GET api/sms/sms-count HTTP/1.1響應(yīng)：備注：字段表示，每次查詢時（目前為 3 秒），新到來的數(shù)量。UI 定時查詢，如果此字段值大于 0，說明在這 3 秒查詢內(nèi)，有新到達(dá)，那么就應(yīng)該下發(fā) sms-list報文獲取列表。由于該字段每次查詢之后會被清 0，所以如果另外一個 UI 頁面（或應(yīng)用程序）再次下發(fā)該接口查詢時，該字段返回值為 0。5.6.3 查詢列表請求：263405000520

45、20500205003字段名類型長度說明M/OPageIndexeger4當(dāng)前頁面索引，索引從 1 開始。500 條，則索引應(yīng)該在1-50之間MReadCounteger4每頁的數(shù)量，目前過 50 條MBoxTypeeger20：設(shè)備M字段名類型長度說明M/OLocareadeger4設(shè)備未讀條數(shù)。MLocalInboxeger4設(shè)備收件箱條數(shù)。MSimUnreadeger4未讀條數(shù)。MSimInboxeger4收件箱條數(shù)。MLocalMaxeger4設(shè)備普通最大量。最小 500，最大不限MSimMaxeger4最大量。MYD/T2013響應(yīng)：27字段名類型長度說明M/OCounteger4數(shù)

46、量MSmseger1類型0：未讀1：已讀2：未發(fā)3：已發(fā)4：發(fā)送失?。愋?2，3，4 可選）MIndexeger8索引MPhonestring32對方號碼，多個號碼用英文逗號隔開MContentstring1024內(nèi)容MDatestring40接收/發(fā)送該的時間，格式為：yyyy-mm-dd hh:mm:ss（如不支持發(fā)送時間則返回 0）MScastring16中心號碼MSaveTypeeger1消息類型提供給界面顯示并回復(fù)SC已收到，但不存儲到NV中，若滿了到OT api/sms/sms-list HTTP/1.111010101:。SortTypeeger1排序字段：0：按時間1：按號碼2：按不支持的排序字段則按時間排序。目前不支持按排序。OAscendingeger1升序降序：0：降序1：升序OUnrereferredeger1排序時是否考慮未讀優(yōu)先0：不考慮1：考慮OYD/T20132810140001o world2011-