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

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