DB14-T 2540-2022 財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心接口規(guī)范

ICS35.080CCSL7714IDB14/T2540—2022前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5基本要求 26接口組成 3參考文獻(xiàn) 6DB14/T2540—2022本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件由山西省財(cái)政廳提出、組織實(shí)施和監(jiān)督檢查。本文件由山西省市場監(jiān)督管理局對標(biāo)準(zhǔn)的組織實(shí)施情況進(jìn)行監(jiān)督檢查。本文件由山西省財(cái)政標(biāo)準(zhǔn)化技術(shù)委員會(SXS/TC48)歸口。本文件起草單位：山西省財(cái)政科學(xué)研究院、山西寶佳質(zhì)量基礎(chǔ)研究院。本文件主要起草人：李林駿、韓慧彥、張寶林、張素娥、王偉、趙姝、邢振軍。1DB14/T2540—2022財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心接口規(guī)范本文件規(guī)定了財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心接口的術(shù)語和定義、縮略語、基本要求和接口組成。本文件適用于財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心接口的設(shè)計(jì)、開發(fā)和應(yīng)用。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。IETFRFC3629UTF-8,ISO10646轉(zhuǎn)換格式（UTF-8,atransformationformatofISO10646）3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1數(shù)據(jù)交換中心將財(cái)政內(nèi)生、外部數(shù)據(jù)統(tǒng)一規(guī)劃并進(jìn)行規(guī)范存儲，為數(shù)據(jù)的分發(fā)和分析提供數(shù)據(jù)基礎(chǔ)的管理系統(tǒng)。3.2Base64一種基于64個可打印ASCII字符對任意字節(jié)數(shù)據(jù)進(jìn)行編碼的算法。3.3第三方系統(tǒng)與財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心交互的其他系統(tǒng)。3.4注冊中心存儲第三方系統(tǒng)IP地址和系統(tǒng)認(rèn)證信息的服務(wù)。4縮略語下列縮略語適用于本文件。HTTP:超文本傳輸協(xié)議（HyperTextTransferProtocol）2DB14/T2540—2022JSON:JS對象簡譜/對象標(biāo)記（JavaScriptObjectNotation）URL:統(tǒng)一資源定位符（UniformResourceLocator）5基本要求5.1接口協(xié)議接口協(xié)議統(tǒng)一采用HTTP協(xié)議。5.2數(shù)據(jù)結(jié)構(gòu)5.2.1基本數(shù)據(jù)類型接口基本數(shù)據(jù)類型見表1。表1基本數(shù)據(jù)類型每一項(xiàng)均為一個子數(shù)據(jù)項(xiàng)，子數(shù)據(jù)項(xiàng)編碼方式與父5.2.2數(shù)據(jù)編碼方式應(yīng)符合IETFRFC3629的規(guī)定。5.2.3數(shù)據(jù)交換格式應(yīng)采用JSON傳輸數(shù)據(jù)。5.3接口調(diào)用地址應(yīng)向財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心獲取接口調(diào)用地址及端口號。5.4安全策略5.4.1在財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心與第三方系統(tǒng)互聯(lián)過程中，應(yīng)采取必要的通信安全措施，采用TLS.IP驗(yàn)證、數(shù)字簽名、用戶身份驗(yàn)證等方法。5.4.2應(yīng)采用Base64加密解密保證數(shù)據(jù)在傳輸過程中的機(jī)密性。5.4.3宜使用3DES、MD5及以上算法，保證數(shù)據(jù)在傳輸過程中的完整性。5.4.4驗(yàn)證和授權(quán)通過以下兩種方式進(jìn)行：3DB14/T2540—2022——確保相互訪問的地址是可信任的，相關(guān)證書通過數(shù)字簽名進(jìn)行驗(yàn)證；——IP驗(yàn)證僅為初步驗(yàn)證請求來源的合法性方法。應(yīng)將第三方系統(tǒng)的IP及相關(guān)認(rèn)證信息存儲至注冊中心，財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心在收到請求時，將請求的IP和系統(tǒng)認(rèn)證信息及注冊中心進(jìn)行對比，確認(rèn)請求源的合法性。5.4.5財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心應(yīng)通過請求頻率和請求配額對單一請求方進(jìn)行限制。5.4.6應(yīng)通過數(shù)字簽名校驗(yàn)保證數(shù)據(jù)不被篡改。6接口組成6.1接口列表財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中心應(yīng)支持的接口見表2。表2接口列表本接口用于第三方系統(tǒng)向財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中本接口用于第三方系統(tǒng)向財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中本接口用于第三方系統(tǒng)向財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中本接口用于第三方系統(tǒng)向財(cái)政業(yè)務(wù)系統(tǒng)數(shù)據(jù)交換中6.2數(shù)據(jù)新增接口數(shù)據(jù)新增接口見表3。表3數(shù)據(jù)新增接口http://ip:port/dmp/v2/a是用戶appid，服務(wù)注冊時填寫，交互時無需傳輸是是是4DB14/T2540—2022是6.3數(shù)據(jù)更新接口數(shù)據(jù)更新接口見表4。表4數(shù)據(jù)更新接口http://ip:port/dmp/v2/agency?t是用戶appid，服務(wù)注冊時填寫，交互時無需傳輸是是是是6.4數(shù)據(jù)刪除接口數(shù)據(jù)刪除接口見表5。表5數(shù)據(jù)刪除接口接口URL是用戶appid，服務(wù)注冊時填寫，交互時無需傳輸是是where是5DB14/T2540—2022是6.5數(shù)據(jù)查詢接口數(shù)據(jù)查詢接口見表6。表6數(shù)據(jù)查詢接口http://ip:port/dmp/v2/agency?&token=&pagesize=&pagenum=&是用戶appid，服務(wù)注冊時填寫，交互時無需傳輸是是否否否where否是6DB14/