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

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