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