GB/T××××—××××PAGE6ICSXXXICSXXXT/CECT/CECXXXX--XXXX北斗衛星電力應用綜合服務平臺接口規范InterfaceSpecificationforBeidouSatelliteApplicationIntegratedServicePlatform（草案）中國電力企業聯合會發布××××-××-××發布××××-××-××實施中國電力企業聯合會發布T/CEC××××—××××PAGEPAGE53目錄前??言 錯誤！未定義書簽。引??言 錯誤！未定義書簽。北斗衛星電力應用綜合服務平臺接口規范 11范圍 12規范性引用文件 13術語和定義和縮略語 13.1術語和定義 13.2縮略語 34總則 41.1接口連接關系 41.2接口功能列表 55基準站接入 75.1邏輯架構 75.2通信協議 76終端接入 96.1通信接入 96.2數據接入 97安全管理 107.1網絡邊界安全防護 107.2應用接口安全防護 117.3數據安全防護 13附錄A（規范性附錄）設備類型標準編碼 15附錄B（規范性附錄）基準站接入要求 16附錄C（規范性附錄）設備接入數據樣例 129北斗衛星電力應用綜合服務平臺接口規范范圍本標準規定了北斗衛星電力應用綜合服務平臺接口要求、數據安全技術要求，北斗衛星電力應用綜合服務平臺數據格式、傳輸協議。本標準適用于北斗衛星電力應用綜合服務平臺與電力北斗基準站間的接口關系、接口協議及數據傳輸。規范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T39267-2020北斗衛星導航術語GB/T39607-2020衛星導航定位基準站數據傳輸和接口協議BDS-SIS-ICD-2.1北斗衛星導航系統空間信號接口控制文件公開服務信號（2.1版本）BD440015-2017北斗地基增強系統國家數據綜合處理系統數據接口規范BD440017-2017北斗地基增強系統基準站數據存儲與輸出要求BD440018-2017北斗地基增強系統基于中國移動通信網數據播發接口規范BD440019-2017北斗地基增強系統基于中國移動多媒體廣播（CMMB）播發接口規范BD410004-2015北斗/全球衛星導航系統（GNSS）接收機導航定位數據輸出格式BD410001-2015北斗/全球衛星導航系統（GNSS）接收機數據自主交換格式BD410003-2015北斗全球衛星導航系統（GNSS）接收機差分數據格式（二）RTCMNTRIP數據傳輸協議（RTCMNTRIPdatatransmissionprotocoll）RTCM10403.2差分GNSS(全球導航衛星系統)服務標準3.2版本（DifferentialGNSS（GlobalNavigationSatelliteSystems）Services-Version3.2）術語和定義和縮略語術語和定義GB/T39267-2020和BD440013-2017界定的術語以及下列術語適用于本文件。基準站referencestation由接收機和天線等設備組成，用于觀測、存儲、傳輸衛星信號數據，并具有基準坐標。數據播發系統databroadcastingsystem使用移動通信、數字廣播、衛星播發等多種手段播發差分數據產品的系統。數據處理平臺dataprocessingsystem由數據接收系統、數據存儲系統、數據處理系統、數據播發系統組成，完成對基準站原始觀測數據的綜合處理，形成和播發差分增強數據產品的系統。北斗地基增強系統BeiDouground-basedaugmentationsystem由地面基準站和數據處理平臺組成。地面基準站網絡實時接收衛星原始觀測數據，通過數據通信網絡將這些基準站觀測數據傳輸至一個或多個數據處理平臺，計算誤差改正信息，生成分米級、厘米級等差分數據產品，并將數據產品提供給用戶終端和其他數據處理系統。數據處理平臺中的數據播發系統通過地面通信網絡向用戶播發差分改正信息，提高用戶定位導航精度。差分定位differentialpositioning一種提高衛星導航定位精度的技術。在已知點上設置衛星導航基準接收機，根據由此獲得的衛星導航觀測值或誤差修正量，實時或事后提供給差分用戶設備，使用戶設備接收并利用修正量以提高其定位精度。實時動態測量real-timekinematic（RTK）GNSS差分定位技術的一種，主要通過基準站和用戶端之間的實時數據鏈路和載波相對定位快速解算技術，實現高精度動態相對定位。廣域差分wideareadifferentialGNSS在較大區域內提高GNSS定位性能的一種技術。利用布設在較大區域內的多個GNSS基準站，監測視野內的GNSS衛星，通過集中數據處理，分類獲得誤差改正參數和完好性信息，并發送給用戶，使用戶獲得較高定位性能。誤差改正參數通常包括星歷誤差改正、衛星鐘誤差改正和電離層延遲改正參數等。區域差分localareadifferentialGNSS在較小區域內提高GNSS定位性能的一種技術。該技術通過一個或多個GNSS基準站的觀測值為區域用戶進行的差分定位。差分數據dataproductofdifferentialGNSS又稱差分改正數據。各類用于修正用戶接收機觀測值的偽距觀測值、載波相位觀測值、多普勒觀測值、衛星信息、坐標轉換信息、軌道信息等數據統稱為差分數據。差分電文differentialmessage將差分數據按照規定格式排列，加上前綴符、數據長度、校驗等信息后形成的二進制數據流。每條電文都具備一個標識字段，稱為電文類型號?？s略語下列縮略語適用于本文件。GNSS：全球衛星導航系統（GlobalNavigationSatelliteSystem）NTRIP：基于互聯網的RTCM數據傳輸協議(NetworkedTransportofRTCMViaInternetProtocol)BDS：北斗衛星導航系統（BeiDouNavigationSatelliteSystem）BDT：北斗時（BDSSystemTime）RTCM：海事無線電技術委員會（Radio

Technical

Commissionfor

MaritimeServices）RTD：實時偽距差分（RealTimeDifference）RTK：實時載波相位差分（RealTimeKinematic）SBAS：星基增強系統（Satellite-BasedAugmentationSystem）TOW：歷元時刻，周內秒（TimeofWeek）URA：用戶測距精度（UserRangeAccuracy）UTC：協調世界時（UniversalTimeCoordinated）ARP：天線參考點（AntennaReferencePoint）GCPCD：幾何載波相位差分改正（GeometricCarrierPhaseCorrectionDifference）GIVEI：格網點電離層垂直延遲誤差指數（GridIonosphericVerticalErrorIndicator）GLONASS：全球導航衛星系統（俄羅斯）（GlobalNavigationSatelliteSystem）GPS：全球定位系統（美國）（GlobalPositioningSystem）ICD：接口控制文件（InterfaceControlDocument）ICPCD：電離層載波相位差分改正（IonosphericCarrierPhaseDifferenceCorrection）ID：信息編號（Identification）IGP：電離層格網點（IonosphericGridPoint）IGS：國際GNSS服務（InternationalGNSSService）IOD：數據齡期（IssueOfData）IODE：星歷數據齡期（IssueOfDataEphemeris）ITRF：國際地球參考框架（InternationalTerrestrialReferenceFrame）TCP/IP：傳輸控制/網絡通信協議（TransmissionControlProtocol/InternetProtocol）總則為適應北斗衛星電力應用綜合服務平臺設計，提高基準站、終端設備與北斗衛星電力應用綜合服務平臺數據傳輸的可靠性和安全性，規范平臺接口建設實施，特制定本標準要求。本標準對接口關系、數據格式及數據傳輸安全技術要求等進行了規定，各類基準站接收機、終端設備等數據采集設備的數據格式設計、數據傳輸設計、生產制造及數據傳輸規定應符合本技術要求規定。北斗衛星電力應用綜合服務平臺涉及的基準站接收機、各類用戶終端設備產品制造除符合本規范規定外，還應符合相應國家標準、行業標準的要求。接口連接關系系統數據接口包括與基準站之間的接口、與其他行業數據處理系統的接口、與北斗衛星電力應用綜合服務平臺之間的接口，連接關系如下圖所示：接口功能列表序號分類接口名稱接口流向備注1權限認證設備鑒權基準站->定位平臺指物聯網平臺對接入平臺的設備進行身份認證2系統信息系統信息上報基準站->定位平臺用于基準站向定位平臺上報系統信息3硬件狀態上報基準站->定位平臺用于基準站向定位平臺上報硬件狀態5網絡狀態上報基準站->定位平臺用于基準站向定位平臺上報網絡狀態6系統控制授權注冊控制定位平臺->基準站用于定位平臺向基準站發送授權注冊控制命令7系統電源控制定位平臺->基準站用于定位平臺向基準站發送系統電源控制命令8固件升級固件升級控制定位平臺->基準站用于定位平臺向基準站發送固件升級控制命令9固件升級上報基準站->定位平臺用于基準站向定位平臺上報升級狀態10工作模式工作模式上報基準站->定位平臺用于基準站向定位平臺上報工作模式11工作模式獲取定位平臺->基準站用于定位平臺向基準站獲取工作模式12工作模式設置定位平臺->基準站用于定位平臺向基準站發送工作模式設置命令13天線參數天線參數上報基準站->定位平臺用于基準站向定位平臺上報天線參數14天線參數獲取定位平臺->基準站用于定位平臺向基準站獲取天線參數15天線參數設置定位平臺->基準站用于定位平臺向基準站發送天線參數設置命令16衛星系統衛星系統上報基準站->定位平臺用于基準站向定位平臺上報衛星系統17衛星系統獲取定位平臺->基準站用于定位平臺向基準站獲取衛星系統18衛星系統設置定位平臺->基準站用于定位平臺向基準站發送衛星系統設置命令19衛星數據差分數據格式獲取定位平臺->基準站用于定位平臺向基準站獲取差分數據格式20差分數據格式設置定位平臺->基準站用于定位平臺向基準站發送差分數據格式設置21導航數據格式獲取定位平臺->基準站用于定位平臺向基準站獲導航分數據格式22導航數據格式設置定位平臺->基準站用于定位平臺向基準站發送導航數據格式設置23原始數據格式獲取定位平臺->基準站用于定位平臺向基準站獲取原始數據格式24原始數據格式設置定位平臺->基準站用于定位平臺向基準站發送原始數據格式設置25數據傳輸數據傳輸上報基準站->定位平臺用于基準站向定位平臺上報數據傳輸26數據傳輸獲取定位平臺->基準站用于定位平臺向基準站獲取數據傳輸27數據傳輸設置定位平臺->基準站用于定位平臺向基準站發送數據傳輸控制命令28數據采集數據采集上報基準站->定位平臺用于基準站向定位平臺上報數據采集29數據采集獲取定位平臺->基準站用于定位平臺向基準站獲取數據采集30數據采集設置定位平臺->基準站用于定位平臺向基準站發送數據采集控制命令基準站接入邏輯架構認證管理、基本配置信息、運行信息、主機配置和數據配置應符合附錄B的規定。通信協議協議約定基準站協議約定示意圖見圖1?；鶞收緟f議約定示意圖觀測數據，基準站使用NTRIPV2.0協議向數據中心上傳差分或者原始數據，一秒一包評率上傳，TCP長連接；靜態信息，基準站以RESTfulAPI方式向運維管理平臺低頻上傳，開機上傳一次，TCP短連接；狀態數據，基準站以FESTfulAPI方式向運維管理平臺高頻上傳，不同命令不同頻率上傳，TCP短連接；控制命令，運維管理平臺部署在網省的遠程控制服務以RESTfulAPI方式向基準站發起請求，TCP短連接。協議結構除NTRIP登錄請求本身是HTTP協議外，其它數據傳輸都應增加HTTP協議頭。接口訪問方式NTRIPV2.0使用通用技術規范。RESTful消息體格式RESTfulAPI消息體需采用JSON格式，HTTPHearder內需指定參數如下：Content-Type:application/json數據中心獲取到Token后，接口請求的Header中需要攜帶Token，格式固定為：-X-Auth-Token:{認證接口發放的Token}RESTful變量類型定義RESTfulAPI遵循JSON格式的類型定義，包括以下幾個類型：數值型（Number）：分為整數型（Integer）和浮點型（Float），均為十進制數值，長度用bit表示。當必選指標無法確定取值時，如無特殊說明，取默認值-1；字符串型（String）：零個或多個字符，長度用char表示。當必選指標無法確定取值時，如無特殊說明，取默認值""；布爾型（Boolean）：true或false，長度為1bit。當必選指標無法確定取值時，如無特殊說明，取默認值false；數組型（Array）：包含零個或多個值，值可以是數組型或其它類型，有順序。當必選指標無法確定取值時，如無特殊說明，取默認值[]；對象型（Object）：Key-Value集合，無順序。當必選指標無法確定取值時，如無特殊說明，取默認值{}；除此之外，還存在幾種特殊類型的變量：時間日期格式的數值視為字符串型；枚舉類型的變量約束了取值范圍，但是變量的值最終還是歸為上述幾種類型。RESTful日期時間格式接口服務器必須采用當地標準時間，中國大陸地區采用UTC+8（北京標準時間）。如無特殊說明，接口中時間類字段數據格式統一為YYYY-MM-DDhh:mm:ss,如：2017-07-2019:15:00。狀態碼狀態碼說明表見表1。狀態碼說明表CodeShorttextDescription200OKeverythingwasfine401UnauthorizedNoorwrongauthorization404NotFoundMountpointofrequestnotfound409ConflictMountpointalreadyinusebyanotherNtripServe終端接入通信接入HTTP接入數據RESTful接口原則，采用Post方式上傳。url中引入參數作為設備解析數據信息。MQTT接入數據宜采用小端方式進行組織。通信Topic由平臺提供，作為數據解析準則。采用設備標識符作為用戶名，進行數據校驗。CoAP接入數據采用Post方式上傳。url中引入參數作為設備解析數據信息。url由下面兩部分組成：服務端IP和端口由平臺提供；url路徑描述：api/v1/{配置項}/{設備編碼}/telemetry,“配置項”由平臺提供，“設備編碼”為設備唯一標識符，作為數據接入準則。數據接入JSON數據格式接入浮點型無效數據傳輸使用NAN。關鍵字段類型和key值見表2。關鍵字段類型和key值表序號類型KEY參數說明單位1Stringdevice_type設備類型--2Stringdevice_sn設備編號--3Int64ts采集時間ms4doublelng經度--5Stringlng_dir經度方向--6doublelat緯度--7Stringlat_dir緯度方向--8intalarm_type告警類型--9intpos_type定位類型--10intstate設備狀態--11intpos_mode定位模式--12intpower_supply供電類型--13intsource_rtk數據來源--14floatbettery電池電量--字節流數據格式接入字節流數據采用小端數據接入。無效數據采用十六進制”FF”作為傳輸數據。安全管理平臺的安全管理標準分為網絡邊界安全防護標準、主機安全防護標準、業務應用安全防護標準、數據安全防護標準、終端安全防護標準。網絡邊界安全防護邊界類型平臺存在的網絡邊界有：管理信息大區橫向邊界。北斗衛星服務與安全接入區邊界。安全接入區與外網邊界。管理信息大區縱向邊界。平臺邊界類型見表3。平臺邊界類型表邊界類型邊界描述管理信息大區橫向邊界管理信息大區等級保護二級域與三級域間邊界北斗衛星服務與安全接入區邊界北斗衛星服務接入與安全接入區邊界管理信息大區縱向邊界總部管理信息大區與網省管理信息大區的邊界邊界安全防護相關管理員應明確網絡邊界，建立邊界網絡接口清單并定期進行審查復核。各個邊界采取的安全防護措施為：管理信息大區橫向邊界安全利用信息內網現有安全域邊界的防火墻設備進行訪問控制，配置訪問控制策略。在網絡邊界對跨越邊界傳輸的信息進行內容過濾，對應用層數據流進行有效的監視和控制。利用信息內網現有安全域邊界的入侵檢測系統對流經邊界的信息流進行入侵檢測，基于對外提供的服務類別（如HTTPS、DNS等）進行入侵防護。配置入侵檢測探頭策略，并對日志進行分析審計。北斗衛星服務與安全接入區邊界安全利用現有部署防火墻、IDS、IPS、網頁防篡改設備、防病毒網關等設備，進行邊界安全防護。非公司信息內網區域信息采集類、移動作業類終端以安全專網方式接入信息內網，必須通過安全接入平臺進行安全認證接入，建立專用加密傳輸通道，實現終端身份認證、安全準入和數據安全交換，結合各業務實際需求開放端口。安全接入區與外網邊界安全利用現有安全接入網關，實現移動終端用戶接入認證和安全防護。管理信息大區縱向邊界安全利用現有部署防火墻、IDS、IPS、網頁防篡改設備、防病毒網關等設備，進行邊界安全防護。應用接口安全防護身份鑒別信息內網用戶通過部署于信息內網的權限系統進行用戶登錄認證（用戶名+口令方式）。授權采用角色控制，限制用戶對系統級資源的訪問。系統管理員角色僅有對系統管理的權限，沒有任何業務權限。對操作方面的權限控制采用前端展現和后端（服務器）共同進行訪問控制。對系統資源訪問控制方面采用統一的鑒權接口。輸入輸出驗證系統對用戶在客戶端輸入或導入的數據進行長度、范圍、數據類型等屬性的合法性進行檢驗，對不合法的數據禁止輸入，并且提示明確的錯誤信息。各模塊設置了保護內部輸入、輸出和存儲期間的用戶數據，以及和用戶直接相關的安全屬性。對于輸入框的長度類型做限制。業務數據直接存儲在數據庫中，敏感信息采用加密方式存儲。針對特殊字符進行檢測，例如單引號、1=1、CDATA、分號、for、loop等，防止XML注入、SQL注入及腳本注入攻擊。通過嚴格限制客戶端可提交的數據類型以及對提交的數據進行有效性檢查等有效措施防止跨站腳本攻擊。在系統頁面通過腳本對用戶輸入的信息進行規則匹配，異步檢測等驗證過濾操作防止跨站腳本攻擊。在系統業務處理層使用代碼規則驗證以及數據查找比對的真實性驗證防止跨站腳本攻擊。配置管理配置使用最少特權進程和服務帳戶，各項配置信息對非管理員賬戶不可讀。通過目錄權限確保配置存儲的安全。用戶授權等配置管理功能只允許管理員角色操作。單獨分配管理特權。禁止通過web頁面直接瀏覽服務端的目錄和文件。制定嚴格的配置變更管理流程，系統關鍵信息例如數據庫連接、運行參數、模板信息等發生配置變更時，需由相關負責人進行審批確認。設置配置信息的保存及版本控制規則，避免發生版本丟失或混淆。使用基于角色的授權策略控制配置管理角色，控制配置權限粒度，配置管理功能只能由經過授權的操作員和管理員訪問。會話管理每次系統登錄成功使用新的會話。關閉網頁客戶端自動會話的安全終止。在服務端保存會話認證信息和會話有效期，當登錄成功后清除舊的會話創建新會話。設置會話存活時間為30分鐘，超時后自動銷毀用戶會話，刪除會話信息。在服務端進行會話信息存儲，對用戶登錄信息及身份憑證進行加密傳輸。用戶登錄后界面提供退出、注銷功能。用戶注銷后，服務端自動清除用戶會話。加密技術用戶密碼采用SM4算法加密后進行傳輸，然后再使用哈希算法進行二次處理后保存。敏感數據采用SM4算法加密后進行傳輸或保存。參數操作每次請求都進行安全檢查，確保用戶沒有繞過檢查，確保用戶查詢的數據是權限范圍內的數據。利用攔截器驗證從客戶端發送的所有數據，對數據進行安全檢查，根據過濾規則截獲敏感字符，并對其進行替換或轉義。配置數據更新操作記錄日志，同時對用戶行為進行流程化操作限制。異常管理對終端用戶屏蔽系統異常，使用通用錯誤信息，將系統拋出的異常信息寫入日志文件。程序發生異常時，終止當前業務，并對當前業務進行回滾操作，保證業務的完整性和有效性，必要時注銷當前用戶會話。應用交互安全通過標準的WebService/HTTP接口與第三方系統集成?；赬ML或JSON與第三方系統交互數據，通過WebService/HTTP方式傳輸。各種收發數據、消息的日志按日期將業務系統使用過程中輸入輸出、錯誤等進行存儲。對于跨站腳本攻擊風險，對系統源代碼進行源代碼掃描和滲透測試，確保沒有跨站腳本攻擊風險隱患。數據安全防護數據存儲安全數據庫連接用戶權限最小。應用系統配置文件中的數據庫用戶名、密碼加密存儲。在數據集成時，為不同的業務系統分配不同的權限，每個賬號僅能訪問授權的數據視圖。數據傳輸安全在系統之間傳輸數據通過WebService/HTTP方式傳輸。在系統內部傳遞默認為POST請求提交，如果用GET方式提交參數必須加密過后進行傳輸。用戶口令傳輸進行加密。數據備份安全支持多臺設備之間數據實時同步。通過數據庫實時備份工具，實現主庫到備庫的實時備份。T/CEC××××—××××T/CEC××××—××××PAGE54

（規范性附錄）

設備類型標準編碼設備類型標準編碼應符合表A.1的要求。設備類型標準編碼序號名稱設備類型1北斗智能手持終端ESM0022軌跡監測裝置PCM0013北斗桿塔傾斜形變監測設備PCS0014北斗工卡PHM0015北斗車載終端PHM0026北斗地址監測站PMS0027北斗安全帽PSM0018北斗智能間隔棒PCM002

（規范性附錄）

基準站接入要求認證管理設備鑒權功能描述平臺設備側支持MQTT協議的connect消息接口，在傳輸層上使用SSL/TLS進行加密傳輸，鑒權通過后建立設備與平臺間的MQTT連接。參數說明字段必須/可選類型參數描述ClientId可選String一機一密的設備clientIdUsername可選String設備IDPassword必選String加密后的設備密鑰鑒權流程基本配置信息數據模型數據模型用于描述產品的功能，是物理空間中的實體（如傳感器、車載裝置、樓宇、工廠等）在云端的數字化表示，從屬性、服務和事件三個維度，分別描述了該實體是什么、能做什么、可以對外提供哪些信息。定義了數據模型的這三個維度，即完成了產品功能的定義。功能類型說明屬性（Property）設備可讀取和設置的能力。一般用于描述設備運行時的狀態，如環境監測設備所讀取的當前環境溫度等。屬性支持GET和SET請求方式。應用系統可發起對屬性的讀取和設置請求。服務（Service）設備可被外部調用的能力或方法，可設置輸入參數和輸出參數。產品提供了什么功能供云端調用。相比于屬性，服務可通過一條指令實現更復雜的業務邏輯，如執行某項特定的任務。事件（Event）設備運行時，主動上報給云端的事件。事件一般包含需要被外部感知和處理的通知信息，可包含多個輸出參數。例如，某項任務完成的信息，或者設備發生故障或告警時的溫度等，事件可以被訂閱和推送。消息主題設備使用MQTT協議接入平臺時，平臺和設備通過Topic進行通信。平臺預置了TOPIC，通過這些預置的Topic，平臺和設備可以實現屬性、命令、事件的交互。數據類型消息類型主題Public

（發布者）Subscriber

（訂閱者）說明屬性相關設備屬性上報/v1/station/properties/report設備平臺用于設備按產品定義的格式將屬性數據上報給平臺平臺查詢設備屬性/v1/station/{code}/properties/get平臺設備用于平臺查詢設備屬性設備返回屬性查詢響應/v1/station/properties/get/response設備平臺用于設備返回屬性查詢結果命令相關平臺下發命令/v1/station/{code}/commands平臺設備用于平臺下發命令，控制設備設備返回命令響應/v1/station/commands/response設備平臺用于設備返回命令控制結果事件相關事件上報/v1/station/events/report設備平臺設備運行時，主動上報給云端的事件消息格式MQTT消息體采用JSON格式進行封裝，具體內容信息參考設備屬性、服務、事件命令。命名規劃采用camelCase標準，例如code、stationModel。通信協議北斗平臺設備數據接入通信協議采用MQTT，兼容V3.X版本。變量類型定義數值型（Number）：分為整數型（Integer）和浮點型（Float），均為十進制數值，長度用bit表示。當必選指標無法確定取值時，如無特殊說明，取默認值-1；字符串型（String）：零個或多個字符，長度用char表示。當必選指標無法確定取值時，如無特殊說明，取默認值""；布爾型（Boolean）：true或false，長度為1bit。當必選指標無法確定取值時，如無特殊說明，取默認值false；數組型（Array）：包含零個或多個值，值可以是數組型或其它類型，有順序。當必選指標無法確定取值時，如無特殊說明，取默認值[]；對象型（Object）：Key-Value集合，無順序。當必選指標無法確定取值時，如無特殊說明，取默認值{}；除此之外，還存在幾種特殊類型的變量：時間日期格式的數值視為字符串型枚舉類型的變量約束了取值范圍，但是變量的值最終還是歸為上述幾種類型日期時間格式接口統一采用當地標準時間，中國大陸地區采用UTC+8（北京標準時間）。如無特殊說明，接口中時間類字段數據格式統一為YYYY-MM-DDhh:mm:ss,如：2017-07-2019:15:00。狀態碼值定義狀態碼值定義，如下表所示：狀態碼狀態碼描述原因0x00連接成功連接成功0x01請求拒絕，協議版本錯誤服務器不支持客戶端請求MQTT協議版0x02請求拒絕，無效的客戶端標識符clientId不符合格式要求或者心跳時間間隔不滿足平臺要求0x03請求拒絕，服務器不可用平臺服務不可用0x04請求拒絕，用戶名或密碼錯誤用戶名或密碼錯誤0x05請求拒絕，沒有授權客戶端沒有權限連接運行信息系統信息上報功能描述基準站接收機每天生成一次接收機系統狀態信息上報到定位平臺，固定上報時間為北京時間8點，如果狀態信息有變更，則主動及時生成上報。Topic上行：/v1/station/properties/report參數說明字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。services必選List<ServiceProperty>設備服務數據列表，多個服務數據可合并上報ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String服務ID，systemInfoproperties必須SystemObject信息內容SystemObject結構定義字段必須/可選類型描述name可選String站點名稱：廣州橋南站address可選String站點地址：廣州市番禺區type必選Integer設備類型：0-未知型接收機；1-授時型接收機2-導航型接收機；3-測地型接收機；4-測量型接收機；5-監測型接收機；manufacturer必選String設備廠商：Hi-TARGETmodel必選String設備型號：VNet8U-Iserialnumber必選String設備編號，11360896，各廠家內部設備唯一標識systemName必選String系統名稱：LinuxsystemVersion必選String系統版本：V3.2.0firmwareVersion必選String固件版本：V2.1.0OEMModel必選String主板型號：UB4B0OEMSerialnumber必選String主板序列號：5935C2987XOEMHardwareVersion必選String主板版本：21319storageCapacity必選Float存儲容量：64.5，單位：GB，參照系統磁盤風格，浮點數表示、保留1位小數點timeZone必選String時區：UTC+1~UTC+11，UTC-11~UTC-1timeStartup必選String系統開機啟動時間：2020/5/1210:32:00timeRegister必選String系統注冊碼有效期：2020/12/3023:59:59示例報文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"systemInfo","properties":{"name":"廣東聯通大廈站","address":"廣東聯通大廈站","type":3,"manufacturer":"HI-TARGET","model":"VNet8U-I","serialnumber":"11360896","systemName":"Linux","systemVersion":"V3.2.0","kernelVersion":"V1.2.0","storageMedium":1,"storageCapacity":64.5,"timeZone":"UTC+8","timeStartup":"2021/10/1510:32:55","timeRegister":"2021/10/1510:32:55"}}]}硬件狀態上報功能描述基準站接收機每隔120秒生成一次接收機物理硬件狀態信息上報到定位平臺，不支持定位平臺主動設置。Topic上行：/v1/station/properties/report參數說明字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。services必選List<ServiceProperty>設備服務數據列表，多個服務數據可合并上報ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String服務ID，hardwareInfoproperties必須HardwareObject信息內容HardwareObject結構定義字段必須/可選類型描述CPURatio必選IntergerCPU利用率%RAMRatio必選IntergerRAM使用率%storageRAW必選List<StorageDetail>已用存儲空間storageUSB必選List<StorageDetail>輸出電源開關：0-關閉，1-開啟storageTFK必選List<StorageDetail>TNC口連接狀態：0-未連接，1-連接temperature必選Float溫度，保留1位小數點voltage必選Floatinexternal內部電源電壓，單位V，保留1位小數點electric必選Interger電量%externalPowerStatus必選Intergerexternal外接電源狀態：0-未連接，1-連接externalPowerVoltage必選Float外接電源電壓，單位V，保留1位小數點USB必選IntergerUSB口接入狀態：0-未連接，1-連接ETH必選IntergerETH開啟狀態：0-未連接，1-連接，有線、無線WIFI、移動4GWIFI必選IntergerWIFI開啟狀態：0-未連接，1-連接BLUE必選IntergerBLUE開啟狀態：0-未連接，1-連接StorageDetail結構體字段名必選/可選類型參數描述status必選Integer0-未掛載，1-掛載total必選Float總共存儲空間，單位：GBused必選Float已用存儲空間，單位：GB，參照系統磁盤風格，浮點數表示、保留1位小數點surplus必選Float剩余存儲空間，單位：GB，參照系統磁盤風格，浮點數表示、保留1位小數點示例報文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"hardwareInfo","properties":{"CPURatio":20,"RAMRatio":60,"storageRAW":[{"status":1,"total":"13.3GB","used":"0.8GB","surplus":"12.5GB"}],"storageUSB":[{"status":1,"total":"13.3GB","used":"0.8GB","surplus":"12.5GB"}],"storageTFK":[{"status":1,"total":"13.3GB","used":"0.8GB","surplus":"12.5GB"}],"temperature":45,"voltage":7.3,"electric":96,"externalPowerSwitch":0,"externalPowerStatus":1,"externalPowerVoltage":220,"USB":0,"ETH":1,"WIFI":0,"BLUE":0}}]}網絡狀態上報功能描述基準站接收機每天生成一次接收機系統網絡狀態信息上報到定位平臺，固定上報時間為北京時間8點，如果狀態信息有變更，則主動及時生成上報。Topic上行：/v1/station/properties/report參數說明字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。services必選List<ServiceProperty>設備服務數據列表，多個服務數據可合并上報ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String服務ID，networkInfoproperties必須NetworkObject信息內容NetworkObject結構定義字段必須/可選類型描述wireline必選List<NetworkDetail>有線網絡，有線網、光纖網，按照傳輸介質分類wireless必選List<NetworkDetail>無線網絡，WIFImobile必選List<NetworkDetail>移動網絡，CDMA網絡制式、GRPS網絡制式NetworkDetail結構體字段名必選/可選類型參數描述state必選Interger啟用狀態：0-禁用；1-啟用status必選Interger運行狀態：0-斷開1-連接physical可選String物理地址，MACprotocol可選StringIP協議：IPV4、IPV6type可選StringManual，Auto（DHCP）,需要確認是DHCP還是什么Autoaddress可選String網絡地址，IPnetmask可選String子網掩碼gateway可選String默認網關domain可選String域名系統（DNS:DomainNameServer）示例報文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"networkInfo","properties":{"wireline":[{"state":1,"status":1,"physical":"F4-39-09-F0-BC","protocol":"IPV4","type":0,"address":"00","netmask":"","gateway":"","domain":""}],"wireless":[{"state":0,"status":0,"physical":"F4-39-09-F0-BC","protocol":"IPV4","type":0,"address":"00","netmask":"","gateway":"","domain":""}],"mobile":[{"state":0,"status":0,"physical":"F4-39-09-F0-BC","protocol":"IPV4","type":0,"address":"00","netmask":"","gateway":"","domain":""}]}}]}主機配置系統控制B.4.1.1 系統信息設置功能描述定位平臺調用基準站提供的接收機系統信息設置接口，實現基準站接收機系統信息設置。Topic下行：/v1/station/{code}/commands上行：/v1/staton/commands/response參數說明1）下行參數字段名必選/可選類型參數描述services必選List<ServiceProperty>設備服務數據列表（控制命令列表）packetId必須String消息ID號。String類型的數字，取值范圍0~4294967295，且每個消息ID在當前設備中具有唯一性。eventTime必選Integer命令下發時間戳，單位毫秒ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String屬性ID，systemInfoproperties必須SystemSettingObject信息內容SystemSettingObject結構定義字段必須/可選類型描述name必選String站點名稱：廣州橋南站address必選String站點地址：廣州市番禺區timeZone必選String時區：UTC+1~UTC+11，UTC-11~UTC-1上行參數字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性services必選List<ServiceProperty>設備服務數據列表（控制命令列表）packetId必須String消息ID號。String類型的數字，取值范圍0~4294967295，且每個消息ID在當前設備中具有唯一性。eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。ServiceProperty結構定義字段名必選/可選類型參數描述serviceId必選String屬性ID，systemInfoproperties可選Object上報信息屬性errorCode必選Interger命令的執行結果，0表示成功，其他表示失敗。不帶默認認為成功。errorMessage必選String命令響應描述，success標識成功示例報文示例：Topic:/v1/station/ZH11359000/commands{"packetId":"1507707025","eventTime":1645696682211,"services":[{"serviceId":"systemInfo","properties":{"name":"廣州橋南站","address":"廣州市番禺區","timeZone":"UTC+8"}}]}Topic:/v1/staton/commands/response{"code":"ZH11359000","packetId":"1507707025","eventTime":1645696682211,"services":[{"errorCode":0,"errorMessage":"success","serviceId":"systemInfo","properties":{}}]}B.4.1.2 本地服務上報功能描述基準站接收機每天生成一次接收機系統軟件和應用軟件運行狀態信息上報到定位平臺，固定上報時間為北京時間8點，如果狀態信息有變更，則主動及時生成上報。Topic上行：/v1/station/properties/report參數說明字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。services必選List<ServiceProperty>設備服務數據列表，多個服務數據可合并上報ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String服務ID，serviceLocalproperties必須ServiceLocalObject信息內容ServiceLocalObject結構定義字段必須/可選類型描述HTTP必選IntergerHTTP服務狀態：0-關閉，1-開啟HTTPPort必選IntergerHTTP服務端口，默認：80FTP必選IntergerFTP服務狀態：0-關閉，1-開啟FTPPort必選IntergerFTP服務端口，默認：21SSH必選IntergerSSH服務狀態：0-關閉，1-開啟SSHPort必選IntergerSSH服務端口，默認：22TEL必選Intergertelnet服務狀態：0-關閉，1-開啟TELPort必選Intergertelnet服務端口，默認：23示例報文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"serviceLocal","properties":{"HTTP":1,"HTTPPort":80,"FTP":0,"FTPPort":21,"SSH":0,"SSHPort":22,"TEL":0,"TELPort":23}}]}B.4.1.3 本地服務控制功能描述定位平臺調用基準站提供的接收機系統服務控制接口，指定基準站接收機連接定位平臺管理地址。Topic下行：/v1/station/{code}/commands上行：/v1/staton/commands/response參數說明1）下行參數字段名必選/可選類型參數描述services必選List<ServiceProperty>設備服務數據列表（控制命令列表）packetId必須String消息ID號。String類型的數字，取值范圍0~4294967295，且每個消息ID在當前設備中具有唯一性。eventTime必選Integer命令下發時間戳，單位毫秒ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String屬性ID，serviceLocalproperties必須ServiceLocalObject信息內容ServiceLocalObject結構定義字段必須/可選類型描述HTTP必選ServiceDetailHTTP服務FTP必選ServiceDetailFTP服務SSH必選ServiceDetailSSH服務TEL必選ServiceDetailTEL服務ServiceDetail結構體字段名必選/可選類型參數描述state必選Integer服務啟用狀態：0-關閉，1-開啟ip必選Integer服務地址port必選Integer服務端口username必選String賬號password必選String密碼connectionMode必選Integer連接方式，1-有線網絡，2-無線網絡，3-移動網絡encryptionMode必選Integer加密方式：0-明文，1-AES-256-GCM加密2）上行參數字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性services必選List<ServiceProperty>設備服務數據列表（控制命令列表）packetId必須String消息ID號。String類型的數字，取值范圍0~4294967295，且每個消息ID在當前設備中具有唯一性。eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。ServiceProperty結構定義字段名必選/可選類型參數描述serviceId必選String屬性ID，serviceLocalproperties可選Object上報信息屬性errorCode必選Interger命令的執行結果，0表示成功，其他表示失敗。不帶默認認為成功。errorMessage必選String命令響應描述，success標識成功示例報文示例：Topic:/v1/station/ZH11359000/commands{"packetId":"1507707025","eventTime":1645696682211,"services":[{"serviceId":"serviceLocal","properties":{"HTTP":{"state":1,"ip":"","port":80,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"FTP":{"state":1,"ip":"","port":21,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"SSH":{"state":1,"ip":"","port":22,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"TEL":{"state":1,"ip":"","port":23,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0}}}]}Topic:/v1/staton/commands/response{"code":"ZH11359000","packetId":"1507707025","eventTime":1645696682211,"services":[{"errorCode":0,"errorMessage":"success","serviceId":"serviceLocal","properties":{}}]}B.4.1.4 遠程服務上報功能描述基準站接收機每天生成一次接收機系統軟件和應用軟件運行狀態信息上報到定位平臺，固定上報時間為北京時間8點，如果狀態信息有變更，則主動及時生成上報。Topic上行：/v1/station/properties/report參數說明字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。services必選List<ServiceProperty>設備服務數據列表，多個服務數據可合并上報ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String服務ID，serviceRemoteproperties必須ServiceRemoteObject信息內容ServiceRemoteObject結構定義字段必須/可選類型描述HTTP必選ServiceDetailHTTP服務狀態：0-關閉，1-開啟MQTT必選ServiceDetailHTTP服務端口，默認：80ServiceDetail結構體字段名必選/可選類型參數描述state必選Integer服務啟用狀態：0-關閉，1-開啟status必選Integer服務連接狀態：0-斷開，1-連接ip必選Integer服務地址port必選Integer服務端口username必選String賬號password必選String密碼connectionMode必選Integer連接方式，1-有線網絡，2-無線網絡，3-移動網絡encryptionMode必選Integer加密方式：0-明文，1-AES-256-GCM加密示例報文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"serviceRemote","properties":{"HTTP":{"state":1,"status":1,"ip":"","port":80,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"MQTT":{"state":1,"status":1,"ip":"","port":1833,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0}}}]}B.4.1.5 遠程服務控制功能描述定位平臺調用基準站提供的接收機遠程服務控制接口，指定基準站接收機連接定位平臺管理地址。Topic下行：/v1/station/{code}/commands上行：/v1/staton/commands/response參數說明1）下行參數字段名必選/可選類型參數描述services必選List<ServiceProperty>設備服務數據列表（控制命令列表）packetId必須String消息ID號。String類型的數字，取值范圍0~4294967295，且每個消息ID在當前設備中具有唯一性。eventTime必選Integer命令下發時間戳，單位毫秒ServicesProperty結構定義字段名必選/可選類型參數描述serviceId必選String屬性ID，serviceRemoteproperties必須ServiceRemoteObject信息內容ServiceRemoteObject結構定義字段必須/可選類型描述HTTP必選ServiceDetailHTTP服務MQTT必選ServiceDetailMQTT服務ServiceDetail結構體字段名必選/可選類型參數描述state必選Integer服務啟用狀態：0-關閉，1-開啟ip必選Integer服務地址port必選Integer服務端口username必選String賬號password必選String密碼connectionMode必選Integer連接方式，1-有線網絡，2-無線網絡，3-移動網絡encryptionMode必選Integer加密方式：0-明文，1-AES-256-GCM加密2）上行參數字段名必選/可選類型參數描述code必選String站點代碼，String類型的數字和字母，如：ZH11359000，且每個設備ID在當前設備中具有唯一性services必選List<ServiceProperty>設備服務數據列表（控制命令列表）packetId必須String消息ID號。String類型的數字，取值范圍0~4294967295，且每個消息ID在當前設備中具有唯一性。eventTime必選Integer設備采集數據時間戳，單位毫秒，設備上報數據不帶該參數或參數格式錯誤時，則數據上報時間以平臺時間為準。ServiceProperty結構定義字段名必選/可選類型參數描述serviceId必選String屬性ID，serviceRemoteproperties可選Object上報信息屬性errorCode必選Interger命令的執行結果，0表示成功，其他表示失敗。不帶默認認為成功。errorMessage必選String命令響應描述，success標識成功示例報文示例：Topic:/v1/station/ZH11359000/commands{"packetId":"1507707025","eventTime":1645696682211,"services":[{"serviceId":"serviceRemote","properties":{"HTTP":{"state":1,"ip":"","port":80,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,