HYT 0371-2023 重點涉海企業(yè)直報系統(tǒng)接口指南

中華人民共和國海洋行業(yè)標準重點涉海企業(yè)直報系統(tǒng)接口指南發(fā)布中華人民共和國自然資源部發(fā)布前言 I 2規(guī)范性引用文件 3術語和定義 4接口功能及流程 4.1獲取服務器公鑰 14.2數據包傳輸 25接口規(guī)范 45.1接口通信方式 45.2傳輸協議 45.3數據格式 45.4接口響應狀態(tài) 46接口方法與報文協議 46.1接口方法 46.2報文結構 5附錄A(資料性)客戶端請求報文格式及示例 7附錄B(資料性)客戶端響應報文格式及示例 附錄C(資料性)數據編碼 參考文獻 I本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由中華人民共和國自然資源部提出。本文件由全國海洋標準化技術委員會(SAC/TC283)歸口。本文件起草單位：國家海洋信息中心。1重點涉海企業(yè)直報系統(tǒng)接口指南1范圍本文件給出了國家重點涉海企業(yè)直報系統(tǒng)(以下簡稱“國家系統(tǒng)”)的接口功能及流程、接口規(guī)范、接口方法及報文協議等方面的內容。本文件適用于國家級與省市級系統(tǒng)間涉海企業(yè)數據的交換和共享。2規(guī)范性引用文件下列文件中的內容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T20794—2021海洋及相關產業(yè)分類HY/T131海洋信息化常用術語3術語和定義GB/T20794—2021、HY/T131規(guī)定的以及下列術語和定義適用于本文件。海洋經濟oceaneconomy開發(fā)、利用和保護海洋的各類產業(yè)活動，以及與之相關聯活動的總和。涉海企業(yè)marine-relatedenterprises在市場監(jiān)督管理部門登記注冊的，從事海洋經濟活動的企業(yè)。重點涉海企業(yè)直報系統(tǒng)directreportingsystemofkeymarinerelatedenterprises依據海洋經濟統(tǒng)計調查制度，涉海企業(yè)通過網絡直接將電子報表報送到海洋經濟統(tǒng)計部門的網絡報送系統(tǒng)。4接口功能及流程4.1獲取服務器公鑰4.1.1接口功能省市級系統(tǒng)調用國家系統(tǒng)接口，獲取基于非對稱加密算法的服務器公鑰，用于后續(xù)加密數據包。省市級系統(tǒng)調用國家系統(tǒng)接口獲取服務器公鑰流程見圖1所示。2開始開始調用國家系統(tǒng)接口服務端公鑰圖1調用國家系統(tǒng)接口獲取服務器公鑰流程圖4.2數據包傳輸4.2.1接口功能省市級系統(tǒng)利用獲取的服務器公鑰，對數據包進行加密后，調用國家系統(tǒng)傳輸接口完成信息報送，并返回報送情況回執(zhí)信息。4.2.2接口流程省市級系統(tǒng)對數據包加密及傳輸詳細流程見圖2所示，省市級系統(tǒng)報送節(jié)點具體流程步驟包括：a)組合本用戶在國家系統(tǒng)內的用戶名、密碼和注冊的IP地址等信息，形成報文頭，組合待上報的報表數據形成報文體，將報文頭和報文體拼接后放置待上報數據包中；b)利用服務器公鑰對數據包進行加密；c)利用加密算法生成客戶端自身密鑰對；d)以加密后的數據和客戶端公鑰作為參數，調用國家系統(tǒng)傳輸接口完成信息傳輸；e)省市級系統(tǒng)獲取服務器回執(zhí)信息，通過客戶端私鑰解密數據，讀取回執(zhí)信息。3驗證用戶信息信息合法性圖2省市級系統(tǒng)的數據包加密及傳輸流程圖國家系統(tǒng)節(jié)點數據解析處理具體流程步驟包括：a)通過國家系統(tǒng)服務器私鑰解密接收到的數據包；b)驗證用戶合法性、企業(yè)信息完整性；c)存儲驗證通過的數據包至國家系統(tǒng)；d)通過客戶端公鑰加密后返回回執(zhí)信息。45接口規(guī)范5.1接口通信方式接口采用同步應答方式，省市級系統(tǒng)發(fā)送數據傳輸請求后，國家系統(tǒng)同步返回處理結果。5.2傳輸協議國家系統(tǒng)接口采用基于安全套接字層的超文本傳送協議(HypertextTransferProtocoloverSecureSocketLayer,HTTPS)和雙向認證的方式，保障交互雙方的有效性和合法性。5.3數據格式接口請求和響應數據均采用可擴展標記語言(ExtensibleMarkupLanguage,XML)或輕量級的數據交換格式(JavaScriptObjectNotation,JSON)格式。5.4接口響應狀態(tài)接口請求響應狀態(tài)碼見表1。表1響應狀態(tài)碼表相關說明6接口方法與報文協議6.1接口方法接口方法及規(guī)定見表2。表2接口方法及規(guī)定獲取服務端公鑰2transferDataSecurit35XML格式請求的基本形式見圖3所示，具體格式說明參見附錄A中的表A.1,詳細數據編碼參見<!--報表數據--><!--企業(yè)名錄-->圖3XML格式請求的基本形式JSON格式請求的基本形式見圖4所示，具體格式說明參見表A.2,詳細數據編碼參見附錄C,詳細{//身份信息//數據信息//報表數據//企業(yè)名錄圖4JSON格式請求的基本形式6<?xmlversion="1.0"encoding//身份信息//數據信息//回執(zhí)信息7(資料性)客戶端請求報文格式及示例表A.1和表A.2給出了客戶端請求報文的具體格式說明，圖A.1和圖A.2給出了客戶端請求JSON格式報文示例說明。表A.1請求信息XML格式報文根節(jié)點業(yè)務服務標識，參照表C.1身份驗證用戶名時間戳身份驗證密碼，經過加密報表名稱編碼，參照表C.2企業(yè)所在地行政區(qū)劃代碼，頻度，參照表C.3報表審核狀態(tài)，1:通過，0:駁回計量單位編碼，參照表C.58數據類型編碼，參照表C.6產業(yè)編碼，參照表C.7業(yè)務服務標識，參照表C.1身份驗證用戶名時間戳報表名稱編碼，參照表C.2企業(yè)所在地行政區(qū)劃代碼，9報表審核狀態(tài)，1:通過，0:駁回行序號從0開始統(tǒng)一社會信用代碼/組織機構代碼修改后的社會信用代碼/組織機構代碼"password":"84a46d872801f0000886cc615ce09c7b",{"regionName":"山東省濟南市天橋區(qū)",}(資料性)客戶端響應報文格式及示例表B.1和表B.2給出了客戶端響應報文的具體格式說明，圖B.1給出了客戶端響應JSON格式報文示例說明。報文根節(jié)點請求響應用戶表B.2響應信息JSON格式請求響應用戶 {}}}重點涉(用)海企業(yè)情況——批發(fā)和零售、住海經定綜1表——水產品加海經定綜1表——工程裝備制注：報表名稱參見《海洋經濟統(tǒng)計調查制度》。表C.3頻度編碼頻度說明0123表C.4指標編碼指標編碼指標名稱重點涉海企業(yè)情況-存貨重點涉海企業(yè)情況-產成品重點涉海企業(yè)情況-稅金及附加重點涉海企業(yè)情況-營業(yè)利潤表C.4指標編碼(續(xù))主要海洋產業(yè)生產情況-海上風電上網電量主要海洋產業(yè)生產情況-海上風電利用小時主要海洋產業(yè)生產情況-海水淡化產量主要海洋產業(yè)生產情況-船舶修理及拆船業(yè)收入主要海洋產業(yè)生產情況-新承接船舶訂單量主要海洋產業(yè)生產情況-海洋工程裝備新承接訂單量主要海洋產業(yè)生產情況-沿海城市接待入境游客人次主要海洋產業(yè)生產情況-沿海城市接待國內游客人次表C.5計量單位編碼計量單位說明噸人表C.5計量單位編碼(續(xù))計量單位說明個項座噸標準煤小時萬千瓦萬千瓦·小時表C.6數據類型編碼數據類型說明當期上期上年同期當期累計表C.7產業(yè)編碼表C.7產業(yè)編碼(續(xù))注：產業(yè)名稱參見GB/T20794—2021。[1]GB/