社會應(yīng)急響應(yīng)信息系統(tǒng) 數(shù)據(jù)接口（征求意見稿）

21在提交反饋意見時，請將您知道的相關(guān)專利連遼寧省市場監(jiān)督管理局發(fā)布IDB21/TXXXX—XXXX前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5數(shù)據(jù)接口交換模型 6基本原則 7接口基本要求 7.1接口協(xié)議要求 7.2接口網(wǎng)絡(luò)要求 7.3接口安全性要求 7.4接口消息要求 7.5接口交換格式要求 7.6接口傳輸要求 8接口功能 9接口管理 9.1接口類型管理 9.2接口關(guān)系管理 9.3接口數(shù)據(jù)狀態(tài)管理 9.4接口歷史信息管理 附錄A（資料性）接口信息 7參考文獻 DB21/TXXXX—XXXX本文件按照GB/T1.1-2020《標(biāo)準化工作導(dǎo)則第1部分：標(biāo)準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由遼寧省工業(yè)和信息化廳提出并歸口。本文件起草單位：沈陽大學(xué)、沈陽華睿博信息技術(shù)有限公司、沈大網(wǎng)聯(lián)汽車、大東區(qū)應(yīng)急管理局、中國煙草總公司遼寧省公司等。本文件主要起草人：趙宏偉、杜世文、李精振、王旭輝、石春鶴、溫朔南、劉揚、吳微、張博、馬國峰、李玉龍、周廣昌、陳東陽、董亮、趙凱、王璞、楊利、趙亞南、秦凱、潘志偉、呂盛凱、龐芷茜、馬梓涵、李雨、邵華等。本文件發(fā)布實施后，任何單位和個人如有問題和意見建議，均可以通過來電和來函等方式進行反饋，我們將及時答復(fù)并認真處理，根據(jù)實際情況依法進行評估及復(fù)審。歸口管理部門通信地址：沈陽市遼寧省沈陽市皇姑區(qū)北陵大街45-2號。歸口管理部門聯(lián)系電話文件起草單位通訊地址：遼寧省沈陽市大東區(qū)望花南街21號。文件起草單位聯(lián)系電話1DB21/TXXXX—XXXX社會應(yīng)急響應(yīng)信息系統(tǒng)數(shù)據(jù)接口本文件給出了社會應(yīng)急響應(yīng)信息系統(tǒng)數(shù)據(jù)接口的交換模型、基本原則、基本要求、接口功能和接口管理等方面內(nèi)容。本文件適用于遼寧省內(nèi)擁有社會應(yīng)急響應(yīng)信息系統(tǒng)的企事業(yè)單位及相關(guān)軟件開發(fā)企業(yè)，為社會應(yīng)急響應(yīng)信息系統(tǒng)數(shù)據(jù)接口的建立、改造等過程提供接口技術(shù)指導(dǎo)。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T25069信息安全技術(shù)術(shù)語DB21/T3466-2021社會應(yīng)急響應(yīng)信息系統(tǒng)基本要求3術(shù)語和定義GB/T25069界定的以及下列術(shù)語和定義適用于本文件。3.1數(shù)據(jù)交換dataexchange執(zhí)法業(yè)務(wù)數(shù)據(jù)在應(yīng)急管理部“互聯(lián)網(wǎng)+執(zhí)法”系統(tǒng)、各省應(yīng)急管理部門自建“互聯(lián)網(wǎng)+執(zhí)法”系統(tǒng)之間互相發(fā)送、傳輸、接收，具體業(yè)務(wù)包括數(shù)據(jù)匯聚和數(shù)據(jù)推送。3.2社會應(yīng)急響應(yīng)信息系統(tǒng)socialemergencyresponseinformationsystem具有一定程度的社會資源且具有可對突發(fā)公共事件提供救災(zāi)救援等應(yīng)急響應(yīng)公共服務(wù)的信息系統(tǒng)。[來源：DB21/T3466-2021,3.2]3.3應(yīng)急響應(yīng)emergencyresponse組織為了應(yīng)對突發(fā)/重大信息安全事件的發(fā)生所做的準備，以及在事件發(fā)生后所采取的措施。4縮略語下列縮略語適用于本文件。API：應(yīng)用程序接口（ApplicationProgramInterface）HTTPS：超文本傳輸安全協(xié)議(HyperTextTransferProtocoloverSecureSocketLayer)JSON：JS對象簡譜(JavaScript0bjectNotation)5數(shù)據(jù)接口交換模型2DB21/TXXXXX—2020社會應(yīng)急響應(yīng)信息系統(tǒng)通過接口向政府應(yīng)急響應(yīng)管理系統(tǒng)發(fā)送請求、請求數(shù)據(jù)，政府應(yīng)急響應(yīng)管理系統(tǒng)通過社會應(yīng)急響應(yīng)信息系統(tǒng)發(fā)送的請求來返回相應(yīng)的數(shù)據(jù)給社會應(yīng)急響應(yīng)信息系統(tǒng)，如圖1所示。社會應(yīng)急響應(yīng)信息系統(tǒng)和政府應(yīng)急響應(yīng)管理系統(tǒng)的具體描述可參照DB21/T3466-2021中第4章的內(nèi)容。數(shù)據(jù)接口模型組成部分的相關(guān)技術(shù)規(guī)范可參考GB/T21062.3-2007的第5章相關(guān)規(guī)定執(zhí)行。圖1接口交換模型6基本原則6.1兼容性數(shù)據(jù)接口能夠支持多種硬件設(shè)備和系統(tǒng)，具備與其他信息系統(tǒng)進行數(shù)據(jù)交換和數(shù)據(jù)共享的能力。6.2易用性數(shù)據(jù)接口易于理解和使用，方便進行數(shù)據(jù)的查詢、傳輸和處理。6.3擴展性同一數(shù)據(jù)接口可通過增加函數(shù)、操作符、語句等形式支持新的功能。6.4安全性數(shù)據(jù)接口具備安全保護措施，包括防病毒感染、防黑客攻擊等，確保數(shù)據(jù)在傳輸和存儲過程中的安全性。7接口基本要求7.1接口協(xié)議要求數(shù)據(jù)接口協(xié)議應(yīng)統(tǒng)一采用HTTPS協(xié)議，接口請求方式為POST請求，采用同步方式進行。7.2接口網(wǎng)絡(luò)要求接口應(yīng)支持通過以下網(wǎng)絡(luò)訪問：a）電子政務(wù)外網(wǎng)；b）互聯(lián)網(wǎng)。7.3接口安全性要求7.3.1身份鑒別3DB21/TXXXX—XXXX對接口訪問者進行身份鑒別，利用強化管理的口令鑒別、基于令牌的動態(tài)口令鑒別、生物特征鑒別、數(shù)字證書鑒別等機制進行身份認證，防止接口被非法調(diào)用。7.3.2數(shù)據(jù)完整性接口消息應(yīng)通過HTTPS進行加密傳輸，能夠檢測到數(shù)據(jù)傳輸過程中數(shù)據(jù)的完整性受到破壞，并采取必要的恢復(fù)措施。7.3.3數(shù)據(jù)保密性對敏感數(shù)據(jù)，應(yīng)采取安全措施(如嚴格的訪問權(quán)限、加密、電子簽名等技術(shù))，防止數(shù)據(jù)被泄漏、竊取和篡改。7.3.4安全審計數(shù)據(jù)文件在交換傳輸全程應(yīng)審計跟蹤，自動記錄數(shù)據(jù)文件的大小、收件人、發(fā)送時間、接收時間和讀取時間等詳細信息。7.4接口消息要求7.4.1消息說明數(shù)據(jù)交換接口消息應(yīng)采用JSON字符串，以鍵值對(Key-Value)的形式封裝。消息請求及響應(yīng)參數(shù)的英文名為JSON字符串鍵值對的鍵名(Key)，消息請求及響應(yīng)參數(shù)采用英文大寫字母、小寫字母、下劃線和破折號表示。消息編碼格式統(tǒng)一采用UTF-8。7.4.2消息參數(shù)格式要求接口消息參數(shù)格式要求如下：a）各參數(shù)若無特別說明均為字符型；b）整數(shù)數(shù)值型參數(shù)不應(yīng)存在除數(shù)字字符以外的其他字符；c）浮點數(shù)值型參數(shù)不應(yīng)存在除小數(shù)點和數(shù)字字符以外的其他字符；d）日期型參數(shù)默認格式為“YYYY-MM-DD”；e）時間型參數(shù)默認格式為“hh:mm:ss”。7.5接口交換格式要求接口交換格式應(yīng)采用JSON字符串傳輸數(shù)據(jù)，具備通用性和可擴展性。7.6接口傳輸要求7.6.1接口請求方式接口請求方式如表1所示。表1接口請求方式7.6.2請求消息格式請求消息參數(shù)請求消息參數(shù)格式如表2所示。4DB21/TXXXXX—2020表2接口消息1是2是3否4否5請求消息示例請求消息的示例如下。{"QMZFC":"dd4dbc732b5cf39d21a512c9a7085c897aa656ed266bc7f69"QCWZ"："0"}7.6.3響應(yīng)消息格式響應(yīng)消息參數(shù)響應(yīng)消息參數(shù)格式如表3所示。表3響應(yīng)消息參數(shù)表12-3-4-響應(yīng)消息示例響應(yīng)消息的示例如下。5DB21/TXXXX—XXXX{}7.6.4接口信息接口信息參考附錄A。8接口功能社會應(yīng)急響應(yīng)信息系統(tǒng)應(yīng)經(jīng)過代碼翻譯、數(shù)據(jù)校驗、格式轉(zhuǎn)換、加密和簽名等處理過程，最后使用通信組件按照約定的通信方式將數(shù)據(jù)打包并發(fā)送至政府應(yīng)急響應(yīng)管理系統(tǒng)。接收方接口系統(tǒng)通過通信組件收到發(fā)起方接口系統(tǒng)的消息報文后，應(yīng)先驗證消息是否可靠、格式是否符合要求、格式轉(zhuǎn)換和代碼翻譯等過程后發(fā)送至政府應(yīng)急響應(yīng)管理系統(tǒng)。接口功能包括但不限于以下方面的內(nèi)容：a）控制組件是系統(tǒng)接口總控組件，用于控制和協(xié)調(diào)接口處理組件的處理順序和過程；b）通信組件用于社會應(yīng)急響應(yīng)信息接口系統(tǒng)與政府應(yīng)急響應(yīng)管理接口系統(tǒng)對外通信服務(wù)層，應(yīng)包括HTTPS通信協(xié)議；c）安全組件用于安全需求，包括提供用于安全需要的加密功能、解密功能、簽名功能和驗證簽名功能等；d）校驗組件用于校驗需求，包括提供數(shù)據(jù)格式和數(shù)據(jù)是否符合接口規(guī)范的校驗功能；e）格式轉(zhuǎn)換組件應(yīng)根據(jù)具體的接口規(guī)范要求，將格式和數(shù)據(jù)解析轉(zhuǎn)換成社會應(yīng)急響應(yīng)信息系統(tǒng)所能理解的格式和數(shù)據(jù)；f）代碼轉(zhuǎn)譯組件傳輸時應(yīng)采用已有國家標(biāo)準或者國際標(biāo)準中規(guī)定的代碼。當(dāng)采用非標(biāo)準代碼轉(zhuǎn)譯功能時，應(yīng)提供相應(yīng)的非標(biāo)準代碼轉(zhuǎn)譯功能。接口功能關(guān)聯(lián)示意圖見圖2。圖2接口功能關(guān)聯(lián)示意圖6DB21/TXXXXX—20209接口管理9.1接口類型管理配置和維護社會應(yīng)急響應(yīng)信息系統(tǒng)數(shù)據(jù)接口類型，應(yīng)包括但不限于接口類型版本、接口類型名稱和接口啟用狀態(tài)等。9.2接口關(guān)系管理配置和維護和政府應(yīng)急響應(yīng)管理系統(tǒng)的接口關(guān)系，應(yīng)包括但不限于接口類型名稱、傳輸方式和接口安全配置等。9.3接口數(shù)據(jù)狀態(tài)管理監(jiān)控接口傳輸狀態(tài)，對于發(fā)送失敗或者接收失敗的信息，應(yīng)提供重新發(fā)送或者重新接收功能。9.4接口歷史信息管理管理接口的歷史信息，宜提供社會應(yīng)急響應(yīng)信息系統(tǒng)規(guī)定的查詢時效。7DB21/TXXXX—XXXX接口信息A.1企業(yè)數(shù)據(jù)查詢接口企業(yè)數(shù)據(jù)查詢接口信息如下：a）服務(wù)名稱：市應(yīng)急局-企業(yè)數(shù)據(jù)查詢接口；b）API服務(wù)地址：https://ip:port/open-api/ResourceID；c）請求方式：GET；d）ResourceID申請權(quán)限時由數(shù)據(jù)管理員提供；e）服務(wù)描述：通過企業(yè)行業(yè)代碼查詢企業(yè)相關(guān)信息數(shù)據(jù)；f）請求消息參數(shù)：見表A.1；g）響應(yīng)消息參數(shù)：詳細描述返回數(shù)據(jù)信息，見表A.2。表A.1請求消息參數(shù)表1C串是2串是d692aa4f4523e8f7691f3ba4963是表“煙花爆竹企業(yè)”4否5否6-否表A.2響應(yīng)消息參數(shù)表1234-返回的數(shù)據(jù)結(jié)果集，采用JSON字符串表示568DB21/TXXXXX—2020表A.2響應(yīng)消息參數(shù)表（續(xù)）789 - --- ----- --------- --9DB21/TXXXX—XXXX表A.2響應(yīng)消息參數(shù)表（續(xù)）--- B），B），-----B），B），B），B），A.2應(yīng)急隊伍查詢服務(wù)接口應(yīng)急隊伍查詢服務(wù)接口信息如下：a）服務(wù)名稱：市應(yīng)急局-應(yīng)急隊伍查詢服務(wù)；b）API服務(wù)地址：https://ip:port/open-api/ResourceID；c）請求方式：GET；d）ResourceID申請權(quán)限時由數(shù)據(jù)管理員提供；e）服務(wù)描述：通過企業(yè)行業(yè)代碼查詢企業(yè)相關(guān)信息數(shù)據(jù)；f）請求消息參數(shù)：見表A.3；g）響應(yīng)參數(shù)信息：詳細描述返回數(shù)據(jù)信息，見表A.4。表A.3請求消息參數(shù)表1C串是2串是d692aa4f4523e8f7691f3ba4963是表“煙花爆竹企業(yè)”4否10DB21/TXXXXX—2020表A.3請求消息參數(shù)表（續(xù)）5否6否表A.4響應(yīng)消息參數(shù)表1234-返回的數(shù)據(jù)結(jié)果集，采用JSON字符串表示5數(shù)據(jù)的唯一標(biāo)示符6-7人的居住地點或機構(gòu)所在地的名稱8-9---數(shù)值型人的數(shù)量，單位：人日期時間型-所學(xué)專業(yè)的稱謂 數(shù)值型數(shù)值型A.3應(yīng)急專家查詢服務(wù)接口應(yīng)急專家查詢服務(wù)接口信息如下：a）服務(wù)名稱：市應(yīng)急局-應(yīng)急隊伍查詢服務(wù)；b）API服務(wù)地址：https://ip:port/open-api/ResourceID；c）請求方式：GET；d）ResourceID申請權(quán)限時由數(shù)據(jù)管理員提供；e）服務(wù)描述：本服務(wù)用于查詢應(yīng)急專家的信息；f）請求消息參數(shù)：見表A.5；g）響應(yīng)參數(shù)信息：詳細描述返回數(shù)據(jù)信息，見表A.6。DB21/TXXXX—XXXX表A.5請求消息參數(shù)表1C是2是如:d692aa4f4523e8f7691f3ba4表A.6響應(yīng)消息參數(shù)表1234-返回的數(shù)據(jù)結(jié)果集，采用JSON字符串表示5 6 78-9-位：歲---職務(wù)/職稱---12DB21/TXXXXX—2020表A.6響應(yīng)消息參數(shù)表（續(xù)） -A.4隱患處置查詢服務(wù)接口隱患處置查詢接口信息如下：a）服務(wù)名稱：市應(yīng)急局-隱患處置查詢服務(wù)；b）API服務(wù)地址：https://ip:port/open-api/ResourceID；c）請求方式：GET；d）ResourceID申請權(quán)限時由數(shù)據(jù)管理員提供；e）服務(wù)描述：本服務(wù)接口通過時間查詢隱患處置信息數(shù)據(jù)；f）請求消息參數(shù)：見表A.7；g）響應(yīng)參數(shù)信息：詳細描述返回數(shù)據(jù)信息，見表A.8。表A.7請求消息參數(shù)表1C串是2串是d692aa4f4523e8f7691f3ba4963是表“煙花爆竹企業(yè)”4否5否6否表A.8響應(yīng)消息參數(shù)表12DB21/TXXXX—XXXX表A.8響應(yīng)消息參數(shù)表（續(xù)）34-返回的數(shù)據(jù)結(jié)果集，采用JSON字符串表示56-78 9 --- ----- -A.5隱患信息查詢接口隱患信息查詢接口信息如下：a）服務(wù)名稱：市應(yīng)急局-隱患信息查詢服務(wù)；b）API服務(wù)地址：https://ip:port/open-api/ResourceID；c）請求方式：GET；d）ResourceID申請權(quán)限時由數(shù)據(jù)管理員提供；e）服務(wù)描述：本服務(wù)接口通過時間查詢隱患信息數(shù)據(jù)；f）請求消息參數(shù)：見表A.9；g）響應(yīng)參數(shù)信息：詳細描述返回數(shù)據(jù)信息，見表A.10。表A.9請求消息參數(shù)表型1C是14DB21/TXXXXX—2020表A.9請求消息參數(shù)表（續(xù)）型2是d692aa4f4523e8f7691f3ba4963圍是-4否5否6是表“大連市”表A.10響應(yīng)消息參數(shù)表1234 返回的數(shù)據(jù)結(jié)果集，采用JSON字符串表示56-7-8-9---- ----DB21/TXXXX—XXXX表A.10響應(yīng)消息參數(shù)表（續(xù)）risk:風(fēng)險分級，hd:隱患排查，mon-- B），B），-B），B），-- -- --- -- YY-MM-DD;--A.6部門單位巡檢記錄明細查詢接口部門單位巡檢記錄明細查詢接口信息如下：a）服務(wù)名稱：市應(yīng)急局-部門單位巡檢記錄明