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

ICS 35.240L72

DB37山 東 省 地 方 標(biāo) 準(zhǔn)DB37/T3522—2019政務(wù)信息資源數(shù)據(jù)交換規(guī)范Governmentinformationresources—Datasharedexchangespecification20192019032120190421山東省市場監(jiān)督管理局發(fā)布目 次前言 II范圍 1規(guī)性用1定和1縮1交方式 22務(wù)2表4件4交流程 5流程 5表6件表6件67交安全 6附錄A（范附）口用回定義 8附錄B（料附）務(wù)口述息示例 9參考10前 言本標(biāo)準(zhǔn)按GB/T1.1—2009給出的規(guī)則起草。本標(biāo)準(zhǔn)由山東省大數(shù)據(jù)局提出、歸口并監(jiān)督實施。（政務(wù)信息資源數(shù)據(jù)交換規(guī)范范圍本標(biāo)準(zhǔn)規(guī)定了政務(wù)信息資源的交換方式、交換流程和交換安全要求。本標(biāo)準(zhǔn)適用于政務(wù)信息資源的數(shù)據(jù)交換。GB/T3304—1991中國各民族名稱的羅馬字母拼寫法和代碼GB/T2261.1—2003個人基本信息分類與代碼第1部分：人的性別代碼DB37/T3520—2019政務(wù)數(shù)據(jù)資源體系總體架構(gòu)DB37/T3521.1—2019政務(wù)信息資源目錄第1部分：編碼規(guī)則下列定義和術(shù)語適用于本文件。下列定義和術(shù)語適用于本文件。3.1政務(wù)信息資源governmentaffairsinformationresources[DB/T3520—2019，定義3.1]3.2信息資源代碼informationresourcecode用于唯一標(biāo)識政務(wù)信息資源的一組字符。[DB/T3521.1—2019，定義3.3]3.3交換exchange信息資源提供方和信息資源需求方間通過政務(wù)信息資源共享交換平臺實現(xiàn)政務(wù)信息資源在線傳送的過程。4縮略語下列縮略語適用于本文件。HTTP：超文本傳輸協(xié)議(HypertextTransferProtocal)HTTPS(SecureHypertextTransferProtocal)WSDL：Web(WebServicesDescriptionLanguage)SOAPSimpleObjectAccessProtocol)RESTRepresentationalStateTransfer)Utf-8：Unicode的可變長度字符編碼(8-bitUnicodeTransformationFormat)概述（（）（服務(wù)接口設(shè)計的基本原則包括但不限于：服務(wù)接口設(shè)計的基本原則包括但不限于：接口分為查詢類、驗證類、數(shù)據(jù)傳輸類、下載類及其他類，接口分類代碼見表1。表1接口分類代碼代碼分類名稱1查詢類2驗證類3數(shù)據(jù)傳輸類4下載類9其他類1。圖1服務(wù)接口代碼結(jié)構(gòu)服務(wù)接口代碼編碼規(guī)則如下：112～1312DB37/T3521.1—201912000001000001～999999999999；1411～節(jié)；15～16201～99。服務(wù)接口技術(shù)要求包括但不限于：HTTP/HTTPS1.0/1.1SOAP1.1/1.2HTTP1.0/1.1WSDL1.1、SOAP1.1/1.2IPWebServiceRESTRESTRESTApiKey。RESTHeaderAppKey、AppSecret、ApiKeyApiSecret，POSTBodyApplication/JSONWebServiceHeaderBodyUtf-8xml、JSONA。B。應(yīng)通過共享交換平臺分配的接口密鑰、訪問令牌等方式對調(diào)用服務(wù)申請進(jìn)行授權(quán)驗證。庫表交換要求包括但不限于：數(shù)據(jù)導(dǎo)入方式，僅適用于結(jié)構(gòu)化數(shù)據(jù)。對于非結(jié)構(gòu)化數(shù)據(jù)，無交換格式限制。對于結(jié)構(gòu)化數(shù)據(jù)，應(yīng)支持txt總流程基于共享交換平臺的資源共享交換總流程見圖2，包括但不限于：圖2交換總流程圖2交換總流程服務(wù)接口交換流程包括但不限于：庫表資源交換流程包括但不限于：文件資源交換流程包括但不限于：7交換安全政務(wù)資源交換安全要求包括但不限于：a)應(yīng)對提供方和需求方進(jìn)行身份和權(quán)限驗證，避免非法請求；附錄A（）服務(wù)接口調(diào)用返回碼定義見表A.1。表A.1接口調(diào)用返回碼定義序號返回碼返回碼描述1200請求成功，請求所希望的響應(yīng)頭或數(shù)據(jù)體將隨此響應(yīng)返回。2300請求失敗，程序執(zhí)行異?；蚴?，無法返回正確的響應(yīng)結(jié)果。3400錯誤請求。4403請求成功，服務(wù)器已經(jīng)理解請求，但無權(quán)限而拒絕執(zhí)行它。5404請求失敗，請求所希望得到的資源未被在服務(wù)器上發(fā)現(xiàn)。6500請求失敗，服務(wù)器遇到了一個未曾預(yù)料的狀況，導(dǎo)致了它無法完成對請求的處理。7504請求超時。附錄B（資料性附錄）服務(wù)接口描述信息填寫示例用戶信息查詢接口描述信息填寫示例見表B.1。表B.1用戶信息查詢接口描述信息填寫示例接口概述通過公民身份號碼、姓名、性別，在人口庫中定位人員信息，并將該人的性別、民族、出生日期、出生地信息和死亡標(biāo)識進(jìn)行反饋。接口名稱省公安廳人口信息查詢接口接口分類查詢類接口方式WebService接口地址http://80:443/gateway/1/sgatxxcx接口授權(quán)資源提供方授權(quán)接口方法cxreceiveRequest輸入（業(yè)務(wù)請求參數(shù)說明）參數(shù)名參數(shù)說明類型約束sfzh公民身份證號碼字符型必填xm姓名字符型必填xb性別，性別的標(biāo)識代碼按GB/T2261.1—2003的規(guī)定取值字符型必填輸出（業(yè)務(wù)返回參數(shù)）參數(shù)名參數(shù)說明類型備注sfzh公民身份證號碼字符型非空項xm姓名字符型非空項xb性別，性別的標(biāo)識代碼按GB/T2261.1—2003的規(guī)定取值字符型非空項mz民族，民族的標(biāo)識代碼按GB/T3304-1991的規(guī)定取值字符型非空項csrq出生日期字符型非空項csd出生地，國家-省-市-縣-詳細(xì)