ICS35.240.01CCSL67DB23黑龍江省地方標準DB23/T2842-2021政務(wù)信息資源數(shù)據(jù)交換規(guī)范黑龍江省市場監(jiān)督管理局發(fā)布DB23/T2842-20212DB23/T2842-2021前??言本文件按照GB/T1.1-2020給出的規(guī)則起草。本文件由黑龍江省營商環(huán)境建設(shè)監(jiān)督局提出并歸口。本文件起草單位：黑龍江省營商環(huán)境監(jiān)督監(jiān)督局、黑龍江省政務(wù)大數(shù)據(jù)中心、黑龍江省標準化研究院。本文件主要起草人：史春光、何振江、曹占立、岳偉強、賈立紅、張憲凱、梅兵、王穎、陳冬冰、陳要武、楊大志、呂猛、王磊、李嚴、王艷君。IDB23/T2842-2021政務(wù)信息資源數(shù)據(jù)交換規(guī)范1范圍本文件規(guī)定了黑龍江省政務(wù)信息資源數(shù)據(jù)交換的通用要求，描述了相應(yīng)的交換方式、交換流程和交換安全等。本文件適用于黑龍江省政務(wù)信息資源的數(shù)據(jù)交換。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2261.1GB/T3304個人基本信息分類與代碼第1部分：人的性別代碼中國各民族名稱的羅馬字母拼寫法和代碼GB/T21063.5政務(wù)信息資源目錄體系第5部分：政務(wù)信息資源標識符編碼方案DB23/T2839政務(wù)信息資源目錄第1部分：編碼規(guī)則總體架構(gòu)政務(wù)信息資源體系3DB23/T2843界定的以及下列術(shù)語和定義適用于本文件。3.1信息資源提供方和信息資源需求方之間通過政務(wù)信息資源共享交換平臺實現(xiàn)政務(wù)信息資源在線傳通過政務(wù)信息資源共享交換平臺提供政務(wù)信息資源的各級政務(wù)部門。1DB23/T2842-2021通過政務(wù)信息資源共享交換平臺獲取政務(wù)信息資源的各級政務(wù)部門。4縮略語下列縮略語適用于本文件。HTTP：超文本傳輸協(xié)議(HypertextTransferProtocol)HTTPS：安全超文本傳輸協(xié)議(SecureHypertextTransferProtocol)WSDL：Web服務(wù)描述語言(WebServicesDescriptionLanguage)SOAP：簡單對象訪問協(xié)議(SimpleObjectAccessProtocol)REST：表述性狀態(tài)傳遞(RepresentationalStateTransfer)UTF-8：Unicode的可變長度字符編碼(8-bitUnicodeTransformationFormat)5交換方式5.1概述信息資源提供方和信息資源需求方通過政務(wù)信息資源共享交換平臺實現(xiàn)政務(wù)信息資源的交換。數(shù)據(jù)交換方式包括但不限于：a)接口方式：通過服務(wù)接口實現(xiàn)數(shù)據(jù)交換或功能調(diào)用，適用于實時性和靈活性要求較高、數(shù)據(jù)量較小的數(shù)據(jù)交換；b)庫表方式：以數(shù)據(jù)庫表結(jié)構(gòu)形式的交換方式，適用于體量大、數(shù)據(jù)增量更新頻繁的數(shù)據(jù)交換；c)文件方式：通過文件發(fā)送的方式將規(guī)范化的數(shù)據(jù)文件傳送到指定的交換節(jié)點，適用于非結(jié)構(gòu)化數(shù)據(jù)或更新較緩慢的結(jié)構(gòu)化數(shù)據(jù)的交換。5.2.1設(shè)計原則a)安全性原則：提供多種安全可靠的技術(shù)手段，保證接口數(shù)據(jù)的安全；b)開放性原則：采用通用的接口設(shè)計標準，保證與其他系統(tǒng)的互聯(lián)互通；c)靈活性原則：能根據(jù)業(yè)務(wù)變化，靈活調(diào)整接口容量與性能；d)松耦合原則：避免接口服務(wù)的實現(xiàn)對提供方業(yè)務(wù)系統(tǒng)的依賴性。接口名稱采用中文名稱，由提供方名稱、資源名稱和接口分類三部分組成。提供方名稱宜使用國家示例：黑龍江省公安廳簡稱為省公安廳。2DB23/T2842-2021表1接口分類代碼代碼分類名稱查詢類12349驗證類數(shù)據(jù)傳輸類下載類其他類接口代碼.1服務(wù)接口代碼由接口提供方代碼、政務(wù)信息資源代碼、接口分類代碼和接口順序碼四部分組成，代碼結(jié)構(gòu)見圖1。a)接口提供方代碼，使用1位大寫英文字母表示，“T”標識資源提供方開發(fā)接口，“P”標識共享交換平臺統(tǒng)一開發(fā)接口；b)政務(wù)信息資源代碼，使用阿拉伯數(shù)字表示，具體見黑龍江省地方標準-政務(wù)信息資源目錄第1部分：編碼規(guī)則；c)接口分類代碼，使用1位阿拉伯數(shù)字表示，編碼范圍為1～9，分類代碼見節(jié)；d)接口順序碼，使用2位阿拉伯數(shù)字表示，用于標識同一接口分類下的接口順序，編碼范圍為01～99。a)服務(wù)傳輸協(xié)議：符合HTTP/HTTPS1.0/1.1標準；b)服務(wù)消息協(xié)議：WebService服務(wù)消息封裝符合SOAP1.1/1.2標準；REST服務(wù)消息封裝符合HTTP1.0/1.1標準；3DB23/T2842-20215.2.4開發(fā)要求服務(wù)接口包括共享交換平臺和提供方開發(fā)的接口。共享交換平臺開發(fā)的接口由需求方提出申請，提供方提供系統(tǒng)IP地址、用戶名、密碼、接口功能名稱等信息，并由共享交換平臺接口開發(fā)人員編寫需求文檔。服務(wù)接口開發(fā)要求包括但不限于：a)接口名稱：接口的中文名稱符合的規(guī)定；b)接口方式：一般包括WebService和REST兩種方式，若為REST方式，標明REST操作；c)接口方法：命名采用大小寫混合的形式，以小寫字母開頭，名稱中其他單詞的首字母以大寫字母開頭，不宜使用下劃線分割單詞；d)接口測試：接口對共享交換平臺開放測試權(quán)限，并提供測試用例；e)接口授權(quán)：提供方授權(quán)的接口明確管控參數(shù)ApiKey；f)接口參數(shù)：1)REST類型的服務(wù)接口，僅允許在Header里傳入授權(quán)驗證相關(guān)的參數(shù)，不允許使用共享交換平臺保留的參數(shù)名AppKey、AppSecret、ApiKey、ApiSecret，POST方式的接口支持在Body中傳遞Application/JSON格式的參數(shù)；2)WebService類型的服務(wù)接口，不允許在Header傳遞參數(shù)，在Body中傳遞；3)傳遞參數(shù)為中文字符時，采用UTF-8編碼。g)返回數(shù)據(jù)：1)接口注冊時標明接口的返回格式；2)返回數(shù)據(jù)采用固定的格式封裝，一般為xml、JSON等；3)接口調(diào)用不通過，可通過返回碼返回數(shù)據(jù)，接口調(diào)用返回碼定義見附錄A。服務(wù)接口發(fā)布時，與政務(wù)信息資源目錄相對應(yīng)，并準確填寫接口描述信息。接口描述信息包括但不限于接口概述、接口名稱、接口分類、接口方式、接口地址、接口授權(quán)、接口方法、輸入輸出參數(shù)以及接口實例。接口主要描述信息填寫要求包括但不限于：a)接口概述：描述出接口提供方功能；b)接口授權(quán)：明確服務(wù)授權(quán)方，包括共享交換平臺和提供方；提供方若因業(yè)務(wù)變化，需對交換數(shù)據(jù)進行變更時，在不影響使用的原則下對已發(fā)布的服務(wù)接口更新，接口更新時應(yīng)保留原版本。服務(wù)接口更新要求包括但不限于：a)應(yīng)提前在本級共享交換平臺進行更新備案，說明服務(wù)更新的計劃停止時間、重新啟動時間、變更內(nèi)容等；b)避免在工作時間內(nèi)進行服務(wù)接口更新；通過共享交換平臺分配的接口密鑰、訪問令牌等方式對調(diào)用服務(wù)申請進行授權(quán)驗證。4DB23/T2842-20215.3庫表交換庫表交換要求包括但不限于：a)按照數(shù)據(jù)交換內(nèi)容在提供方和需求方部署的前置服務(wù)器上安裝數(shù)據(jù)庫并創(chuàng)建數(shù)據(jù)庫表；b)提供方和需求方提前約定數(shù)據(jù)交換格式、交換頻率、交換內(nèi)容等；c)需求方在共享交換平臺填寫申請資料時選定數(shù)據(jù)類型；d)數(shù)據(jù)獲取后，需求方對獲取的入庫時間、入庫記錄數(shù)量、交換數(shù)據(jù)來源等內(nèi)容向提供方確認。5.4文件交換文件交換方式應(yīng)將無承載系統(tǒng)的資源，通過數(shù)據(jù)錄入或數(shù)據(jù)導(dǎo)入的方式存入共享交換平臺數(shù)據(jù)庫表中，由共享交換平臺提供統(tǒng)一接口用于交換。數(shù)據(jù)錄入方式，適用于非結(jié)構(gòu)化數(shù)據(jù)和數(shù)據(jù)量較小的情況；數(shù)據(jù)導(dǎo)入方式，僅適用于結(jié)構(gòu)化數(shù)據(jù)。對于非結(jié)構(gòu)化數(shù)據(jù)，無交換格式限制。對于結(jié)構(gòu)化數(shù)據(jù)，支持xml、xls、txt等格式文件。6交換流程6.1總流程基于共享交換平臺的資源共享交換總流程包括但不限于：a)提供方整理可共享交換的資源，完成資源目錄的編目與報送；b)提供方在共享交換平臺完成資源發(fā)布；c)需求方通過共享交換平臺進行檢索，對所需的資源進行申請：1)對于無條件共享的資源，需求方在共享交換平臺備案后獲取資源；2)對于有條件共享的資源，需由提供方審核，審核通過后完成資源獲取。d)提供方通過共享交換平臺以接口、庫表、文件等交換方式提供需求方所需資源；e)需求方獲取資源；f)需求方對獲取資源進行審核：1)若提供資源與所需資源一致，需求方可直接獲取使用；2)若提供資源與所需資源不一致，需求方通過共享交換平臺提交糾錯意見，并提供政務(wù)信息資源目錄、信息資源格式類型、信息資源名稱、問題描述、聯(lián)系人、聯(lián)系電話、郵箱等信息，提供方通過共享交換平臺查看糾錯意見，并將意見反饋給需求方，需求方可重新申請資源。交換總流程見圖2。5DB23/T2842-20211)需求方通過共享交換平臺的服務(wù)接口列表、分類檢索和接口搜索等功能進行服務(wù)信息的查找，獲得服務(wù)接口注冊信息；2)需求方對資源進行申請，填寫申請部門、申請時間、調(diào)用頻率、用途說明等相關(guān)信息，獲取授權(quán)。6DB23/T2842-2021d)接口調(diào)用：獲得授權(quán)后，需求方使用授權(quán)碼進行服務(wù)接口調(diào)用。6.3庫表交換庫表資源交換流程包括但不限于：a)資源發(fā)布：提供方將在準備的可共享數(shù)據(jù)庫表信息加載到共享交換平臺數(shù)據(jù)表中，并登錄共享交換平臺，完成資源發(fā)布；b)資源申請與審核；1)需求方在共享交換平臺填寫相應(yīng)的申請資料，對需要的庫表資源進行申請；2)提供方對資源申請進行審核反饋。c)資源提供：1)補充配置信息：提供方和需求方在共享交換平臺，對已申請的資源補充配置信息，如服務(wù)器地址、數(shù)據(jù)庫類型、數(shù)據(jù)庫版本等；2)平臺配置：共享交換平臺工作人員對提供方和需求方部署的前置庫進行聯(lián)調(diào)。d)資源獲取：需求方從共享交換平臺數(shù)據(jù)表中獲取資源。6.4文件交換文件資源交換流程包括但不限于：a)資源發(fā)布：1)交換準備：提供方將準備好的共享文件上傳至共享交換平臺前置節(jié)點；2)交換配置：提供方登錄共享交換平臺，進行資源注冊、注冊審核、資源發(fā)布等交換配置工作。c)資源提供：提供方審核通過后，給予需求方下載權(quán)限；d)資源獲取：需求方進行數(shù)據(jù)接收準備工作，下載獲取資源。a)應(yīng)對提供方和需求方進行身份和權(quán)限驗證，避免非法請求；b)應(yīng)實時監(jiān)控數(shù)據(jù)交換通道的運行情況，出現(xiàn)問題及時告警；c)應(yīng)提供數(shù)據(jù)傳輸加密措施；d)應(yīng)提供審計功能，記錄提供方、需求方、共享交換平臺維護人員、數(shù)據(jù)交換情況等信息；e)應(yīng)加強共享交換平臺接入口和接入終端的安全保密管理，采取入侵防范、惡意代碼檢測以及信息涉密情況檢查等措施，提高防病毒、防攻擊、防信息泄漏、數(shù)據(jù)防篡改及防竊取等能力；f)應(yīng)通過服務(wù)接口參數(shù)設(shè)置等方式實現(xiàn)來源識別、訪問控制等功能；g)提供方應(yīng)對接口進行授權(quán)，需求方應(yīng)通過唯一授權(quán)碼進行接口調(diào)用。7DB23/T2842-2021AA附錄A（規(guī)范性）接口調(diào)用返回碼定義服務(wù)接口調(diào)用返回碼定義見表A.1。表A.1接口調(diào)用返回碼定義序號返回碼200返回碼描述1234567請求成功，請求所希望的響應(yīng)頭或數(shù)據(jù)體將隨此響應(yīng)返回。請求失敗，程序執(zhí)行異?；蚴。瑹o法返回正確的響應(yīng)結(jié)果。錯誤請求。300400403請求成功，服務(wù)器已經(jīng)理解請求，但無權(quán)限而拒絕執(zhí)行它。請求失敗，請求所希望得到的資源未被在服務(wù)器上發(fā)現(xiàn)。請求失敗，服務(wù)器遇到了一個未曾預(yù)料的狀況，導(dǎo)致無法完成對請求的處理。請求超時。4045008DB23/T2842-2021BB附錄B（資料性）服務(wù)接口描述信息填寫示例用戶信息查詢接口描述信息填寫示例見表B.1。表B.1用戶信息查詢接口描述信息填寫示例通過公民身份號碼、姓名、性別，在人口庫中定位人員信息，并將該人的性別、民族、出生日期、出生地信息和死亡標識進行反饋。接口概述接口名稱接口分類接口方式接口地址接口授權(quán)接口方法省公安廳人口信息查詢接口查詢類WebService/gateway/api/1/ryjbxxcx資源提供方授權(quán)輸入（業(yè)務(wù)請求參數(shù)說明）9DB23/T2842-2021表B.1(續(xù))通過公民身份號碼、姓名、性別，在人口庫中定位人員信息，并將該人的性別、民族、出生日期、出生地信息和死亡標識進行反饋。接口概述民族，民族的標識代碼按GB/T3304的規(guī)定mz字符型非空項取值出生日期csrqcsd字符型字符型字符型非空項非空項