DB37T 3522-2019 政務(wù)信息資源 數(shù)據(jù)交換規(guī)范

DB37Governmentinformationresources—Datasharedexchangespeci山東省市場監(jiān)督管理局發(fā)布I 1 1 1 1 2 2 2 4 4 5 5 6 6 6 6 8 9 本標(biāo)準(zhǔn)按GB/T1.1—2009給出1政務(wù)信息資源數(shù)據(jù)交換規(guī)范GB/T3304—1991中國各民族名稱的羅馬字母拼寫法GB/T2261.1—2003個(gè)人基本信息分類與代碼第1部分：人DB37/T3520—2019政務(wù)數(shù)據(jù)資源體系總DB37/T3521.1—2019政務(wù)信息資源目錄第1部分：編信息資源提供方和信息資源需求方間通過政務(wù)信息資源共享交換平臺(tái)實(shí)現(xiàn)政務(wù)信息資源在線傳送4縮略語2HTTP：超文本傳輸協(xié)議(HypertextTransferProtoHTTPS：安全超文本傳輸協(xié)議(SecureHypertextTransferProtoWSDL：Web服務(wù)描述語言(WebServicesDescriptionLanguage)SOAP：簡單對象訪問協(xié)議(SimpleObjectAccessREST：表述性狀態(tài)傳遞(RepresentationalStateTrUtf-8：Unicode的可變長度字符編碼(8-bitUnicodeTransformationForma5.1概述b)庫表方式：以數(shù)據(jù)庫表結(jié)構(gòu)形式的交換方式，適用于體量大、數(shù)5.2服務(wù)接口a)安全性原則：應(yīng)提供多種安全可靠的技術(shù)手段，保證接口數(shù)據(jù)的安全；b)開放性原則：應(yīng)采用通用的接口設(shè)計(jì)標(biāo)準(zhǔn)，保證與其他系統(tǒng)的互聯(lián)互通；c)靈活性原則：應(yīng)能根據(jù)業(yè)務(wù)變化，靈活調(diào)整接口容量與性能；d)松耦合原則：應(yīng)避免提供方的業(yè)務(wù)系統(tǒng)對接口服務(wù)實(shí)現(xiàn)的依賴性。接口名稱用國家規(guī)定的部門簡稱，如山東省公安廳簡稱為接口分類123493接口代碼2位接口順序碼1位接口分類代碼12位政務(wù)信息資源代碼1位接口提供方代碼圖1服務(wù)接口代碼結(jié)構(gòu)a)第1位為接口提供方代碼，使用1位大寫英文字母表示，“T”標(biāo)識(shí)資源提供方開發(fā)接口，“P”b)第2~13位為政務(wù)信息資源代碼，使用12位阿拉伯?dāng)?shù)字表示，采用DB37/T3521.1-2019信息資源代碼的后12位，編碼范圍從000001000001～999999999999;c)第14位為接口分類代碼，使用1位阿拉伯?dāng)?shù)字表示，編碼范圍為1～9,分類代碼見d)第15～16位為接口順序碼，使用2位阿拉伯?dāng)?shù)字表示，用于標(biāo)識(shí)同一接口分類下的接口順序，編碼范圍為01～99。a)服務(wù)傳輸協(xié)議：應(yīng)符合HTTP/HTTPS1.0/1.1標(biāo)準(zhǔn)；c)服務(wù)描述要求：服務(wù)描述的內(nèi)容格式應(yīng)符合WSDL1.1、SOAP1.1/1.2標(biāo)準(zhǔn)。5.2.4開發(fā)要求a)接口名稱：接口的中文名稱應(yīng)符合的規(guī)定。b)接口方式：一般包括WebService和REST兩種方式，若為REST方式，應(yīng)標(biāo)明REST操作。d)接口測試：接口應(yīng)對共享交換平臺(tái)開放測試權(quán)限，并提供測試用例。e)接口授權(quán)：提供方授權(quán)的接口應(yīng)明確管控參數(shù)ApiKey。4換平臺(tái)保留的參數(shù)名AppKey、AppSecret、ApiKey、ApiSecret，PO2)WebService類型的服務(wù)接口，不允許在Header傳遞參數(shù)，應(yīng)在Body中進(jìn)行傳遞；3)傳遞參數(shù)為中文字符時(shí)，應(yīng)采用Utf-8編碼。2)返回?cái)?shù)據(jù)應(yīng)采用固定的格式封裝，一般為xml、JSON等；3)接口調(diào)用不通過，可通過返回碼返回?cái)?shù)據(jù)，接口調(diào)用返回碼定義見附錄A。以及接口實(shí)例。接口主要描述信息填寫要求a)接口概述：應(yīng)描述出接口的提供方和功能；b)接口授權(quán)：應(yīng)明確服務(wù)授權(quán)方，服務(wù)授權(quán)方包括共享交換平臺(tái)和提供方；c)輸入?yún)?shù)：針對每個(gè)接口方法，應(yīng)給出參數(shù)名、參數(shù)說明、類型、約束等輸入信息；d)輸出參數(shù)：針對每個(gè)接口方法，應(yīng)給出返回值格式等輸出信息；e)接口實(shí)例：提供方應(yīng)提供服務(wù)接口實(shí)例，并標(biāo)注返回參數(shù)含義等信息。應(yīng)通過共享交換平臺(tái)分配的接口密鑰、訪問令5.3庫表交換a)應(yīng)按照數(shù)據(jù)交換內(nèi)容在提供方和需求方部署的前置服務(wù)器上安裝數(shù)據(jù)庫及創(chuàng)建數(shù)據(jù)庫表；b)提供方和需求方應(yīng)提前約定數(shù)據(jù)交換格式、交換頻率、交換內(nèi)容等；5.4文件交換5數(shù)據(jù)導(dǎo)入方式，僅適用于結(jié)構(gòu)化數(shù)據(jù)。對于非結(jié)構(gòu)化數(shù)據(jù)，無交換格式限制。對于結(jié)構(gòu)化數(shù)據(jù)，應(yīng)支持xml、xls、txt等格式文件。基于共享交換平臺(tái)的資源共享交換總流程見圖2,包括但不限于：a)提供方整理可共享交換的資源，完成資源目錄的編目與報(bào)送；b)提供方在共享交換平臺(tái)完成資源發(fā)布；c)需求方通過共享交換平臺(tái)進(jìn)行檢索，對所需的資源進(jìn)行申請：1)對于無條件共享的資源，需求方在共享交換平臺(tái)備案后獲取資源；2)對于有條件共享的資源，需由提供方進(jìn)行審核，審核通過后完成資源獲取。d)提供方通過共享交換平臺(tái)以接口、庫表、文件等交換方式提供需求方所需資源；1)若提供資源與所需資源一致，需求方可直接獲取使用；2)若提供資源與所需資源不一致，需求方應(yīng)通過共享交換平臺(tái)提交糾錯(cuò)意見，并提供政務(wù)信息資源目錄、信息資源格式類型、信息資源名稱、問題描述、聯(lián)系人、聯(lián)系電話、聯(lián)系人郵箱等信息，提供方通過共享交換平臺(tái)查看糾錯(cuò)意見，并將意見反饋給需求方，需求方可重新申請資源。共享交換平臺(tái)共享交換平臺(tái)通過是奇提供方需求方圖2交換總流程61)提供方登錄共享交換平臺(tái)，按照服務(wù)注冊要求填報(bào)注冊2)注冊完成后，共享交換平臺(tái)審核通過后發(fā)布服務(wù)接口，并實(shí)現(xiàn)代理運(yùn)行。c)接口授權(quán)：對于需求方提交的服務(wù)接口申請，提供方對其進(jìn)行授權(quán)；d)接口調(diào)用：獲得授權(quán)后，需求方使用授權(quán)碼進(jìn)行服務(wù)接口調(diào)用。2)平臺(tái)配置：共享交換平臺(tái)工作人員對提供方和需求方部署的前置庫進(jìn)行聯(lián)調(diào)。d)資源獲?。盒枨蠓綇墓蚕斫粨Q平臺(tái)數(shù)據(jù)表中獲取資源。1)交換準(zhǔn)備：提供方將準(zhǔn)備好的共享文件上傳至共享交換平臺(tái)前置c)資源提供：提供方審核通過后，給予需求方下載權(quán)限；d)資源獲取：需求方進(jìn)行數(shù)據(jù)接收準(zhǔn)備工作，下載獲取資源。a)應(yīng)對提供方和需求方進(jìn)行身份和權(quán)限驗(yàn)證，避免非法請求；7b)應(yīng)實(shí)時(shí)監(jiān)控?cái)?shù)據(jù)交換通道的運(yùn)行情況，出現(xiàn)問題及時(shí)告警；f)應(yīng)通過服務(wù)接口參數(shù)設(shè)置等方式實(shí)現(xiàn)來源識(shí)別、訪問控制等功能；g)提供方應(yīng)對接口進(jìn)行授權(quán)，需求方應(yīng)通過唯一授權(quán)碼進(jìn)行接口調(diào)用。812345679通過公民身份號(hào)碼、姓名、性別，在人口庫中定位人員信息，并將該人的性別、WebS