DB3308T 084-2021 部門聯(lián)合獎懲系統(tǒng)數(shù)據(jù)接口技術(shù)規(guī)范

CCSL65DB3308衢州市市場監(jiān)督管理局發(fā)布IDB3308/T084—2021前言 2規(guī)范性引用文件 3術(shù)語和定義 4數(shù)據(jù)交換方式 5數(shù)據(jù)接口功能建設(shè) 6數(shù)據(jù)接口規(guī)范 7數(shù)據(jù)安全要求 附錄A（資料性）接口返回示例 參考文獻(xiàn) DB3308/T084—2021本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利，本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由衢州市營商環(huán)境建設(shè)辦公室提出并歸口。本文件主要起草單位：衢州市營商環(huán)境建設(shè)辦公室、金電聯(lián)行（北京）信息技術(shù)有限公司、衢州市大數(shù)據(jù)中心、浙江省方大標(biāo)準(zhǔn)信息有限公司。本文件主要起草人：曹云、許敬群、李文陽、謝毓晗、傅文濤、陳旭文、陳群、黃健民、祁勁松、王春聰、魏春梅。1DB3308/T084—2021部門聯(lián)合獎懲系統(tǒng)數(shù)據(jù)接口技術(shù)規(guī)范本文件規(guī)定了部門聯(lián)合獎懲系統(tǒng)的數(shù)據(jù)交換方式、數(shù)據(jù)接口功能建設(shè)、數(shù)據(jù)接口規(guī)范、數(shù)據(jù)安全要本文件適用于市級信用信息共享平臺聯(lián)合獎懲系統(tǒng)、統(tǒng)建業(yè)務(wù)辦理系統(tǒng)、部門自建業(yè)務(wù)辦理系統(tǒng)之間的信用數(shù)據(jù)交換與共享。2規(guī)范性引用文件本文件無規(guī)范性引用文件。3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1HTTPS協(xié)議HyperTextTransferProtocolSecure通過計(jì)算機(jī)網(wǎng)絡(luò)進(jìn)行安全通信的傳輸協(xié)議，又稱超文本傳輸安全協(xié)議。4整體架構(gòu)與數(shù)據(jù)來源4.1整體架構(gòu)部門聯(lián)合獎懲系統(tǒng)基于浙江省公共信用信息平臺下放的公共信用產(chǎn)品接口，二次封裝接口后發(fā)布至衢州公共數(shù)據(jù)服務(wù)管理平臺，再由各部門自建統(tǒng)建系統(tǒng)申請接口后嵌入自身業(yè)務(wù)流程中實(shí)現(xiàn)協(xié)同應(yīng)用，數(shù)據(jù)交換架構(gòu)圖見圖1。2接口注冊/發(fā)布人力社保臺公積金管公共資源交易平臺統(tǒng)一權(quán)力運(yùn)行系統(tǒng)部門聯(lián)合獎懲系統(tǒng)數(shù)據(jù)來源于以下兩個(gè)方面：自建統(tǒng)建系統(tǒng)。3DB3308/T084—20216.1.1二次封裝接口應(yīng)采用IP白名單、請求密鑰定時(shí)更新等安全策略，防止信用信息泄漏。6.1.2應(yīng)保持省信用平臺接口推送數(shù)據(jù)、應(yīng)用系統(tǒng)反饋數(shù)據(jù)在二次封裝接口轉(zhuǎn)發(fā)中的完整性。6.1.3應(yīng)用系統(tǒng)應(yīng)獨(dú)立向省信用平臺申請信用接入碼。6.1.4二次封裝接口添加個(gè)性化數(shù)據(jù)的，接口調(diào)用不應(yīng)影響省信用平臺接口執(zhí)行效率。6.1.5二次封裝接口應(yīng)具備異常管理模塊，地市應(yīng)用系統(tǒng)在接口調(diào)用發(fā)生錯(cuò)誤時(shí)，能明確提供錯(cuò)誤產(chǎn)生的原因與處理方式。6.2功能要求6.2.1接口基本功能包括以下內(nèi)容：a)實(shí)時(shí)轉(zhuǎn)發(fā)省平臺推送數(shù)據(jù)及各應(yīng)用系統(tǒng)反饋數(shù)據(jù)；b)對省平臺推送的數(shù)據(jù)及各應(yīng)用系統(tǒng)反饋的數(shù)據(jù)進(jìn)行歸集、整理、存儲。6.2.2信用核查與反饋功能包括以下內(nèi)容：a)業(yè)務(wù)系統(tǒng)應(yīng)在審批全流程嵌入信用核查功能；b)具備信用核查按鈕，展示信用核查頁面；c)每次調(diào)用核查接口均應(yīng)反饋核查措施（可由系統(tǒng)默認(rèn)反饋），若未反饋，應(yīng)提示用戶；d)在辦結(jié)環(huán)節(jié)驗(yàn)證本辦件是否已完成核查反饋，未反饋的辦件應(yīng)提示用戶；e)信用核查頁面按省公共信用信息平臺頁面設(shè)計(jì)規(guī)范設(shè)置。6.2.3批量核查與反饋功能包括以下內(nèi)容：a)具備信用核查按鈕，展示信用核查頁面；b)每次調(diào)用核查接口均應(yīng)反饋核查措施（可由系統(tǒng)默認(rèn)反饋），若未反饋，應(yīng)提示用戶；c)信用查詢頁面按省公共信用信息平臺頁面設(shè)計(jì)規(guī)范設(shè)置。6.2.4容缺承諾與反饋功能包括以下內(nèi)容：a)每次調(diào)用承諾接口應(yīng)保證之后調(diào)用反饋接口，反饋數(shù)據(jù)；b)定期驗(yàn)證本辦件是否已完成容缺反饋，未反饋的辦件應(yīng)提示辦件人員。7數(shù)據(jù)接口規(guī)范7.1信用核查接口7.1.1接口功能用于返回信用主體的信用狀況信息，接口返回本次核查的核查編碼（核查編碼唯一）和信用狀況信息JSON格式的數(shù)據(jù)。數(shù)據(jù)中包含信用主體的企業(yè)信用狀況、企業(yè)信用提示、企業(yè)信用檔案鏈接、法人信用狀況、法人信用提示、法人信用檔案鏈接、紅黑名單獎懲措施信息。4DB3308/T084—20217.1.2接口參數(shù)接口參數(shù)及說明見表1。表1是是是是是是是是7.1.3返回示例返回示例見附錄A中表A.1。7.2核查反饋接口7.2.1接口功能用于核查和獎懲結(jié)果反饋，根據(jù)核查編碼反饋核查或獎懲后的結(jié)果狀態(tài)。7.2.2接口參數(shù)接口參數(shù)見表2。是否是多個(gè)措施使用“$”分隔，例如：“01$02”是5DB3308/T084—20217.2.3返回示例返回示例見附錄A中表A.2。7.3核查狀態(tài)接口7.3.1接口功能用于各系統(tǒng)在辦結(jié)環(huán)節(jié)強(qiáng)制調(diào)用接口時(shí)，確認(rèn)核查結(jié)果是否已反饋。7.3.2接口參數(shù)接口參數(shù)見表3。是7.3.3返回示例返回示例見附錄A中表A.3。7.4批量核查接口7.4.1接口功能用于返回信用主體的信用狀況信息，接口返回本次核查的核查編碼（核查編碼唯一）和信用狀況信息JSON格式的數(shù)據(jù)。JSON數(shù)據(jù)中包含各信用主體的信用狀況、信用檔案鏈接、信用信息。7.4.2接口參數(shù)接口參數(shù)見表4。是是是是6DB3308/T084—2021是7.4.3返回示例返回示例見附錄A中表A.4。7.5批量核查反饋接口7.5.1接口功能用于返回信用主體的信用狀況信息，接口返回本次核查的核查編碼（核查編碼唯一）和信用狀況信息JSON格式的數(shù)據(jù)。JSON數(shù)據(jù)中包含各信用主體的信用狀況、信用檔案鏈接、信用信息。7.5.2接口參數(shù)接口參數(shù)見表5。是多個(gè)措施使用“$”分隔，例如：“01$02”是7.5.3返回示例返回示例見附錄A中表A.5。7.6容缺承諾接口7.6.1接口說明用于向省/市信用平臺推送承諾書數(shù)據(jù)。7.6.2請求參數(shù)接口參數(shù)見表6。7DB3308/T084—2021"patchDate":"承諾日期："patchTimeLimitUnit"",是7.6.3返回示例返回示例見附錄A中表A.6。7.7容缺承諾反饋接口7.7.1接口功能用于向省/市信用平臺推送承諾履約情況數(shù)據(jù)7.7.2請求參數(shù)接口參數(shù)見表7。8DB3308/T084—2021是是是7.7.3返回示例返回示例見附錄A中表A.7。8數(shù)據(jù)安全要求8.1訪問控制請求方使用刷新秘鑰定時(shí)獲取刷新秘鑰和請求秘鑰。8.2數(shù)據(jù)授權(quán)控制數(shù)據(jù)獲取由衢州公共數(shù)據(jù)服務(wù)管理平臺進(jìn)行授權(quán)訪問。8.3數(shù)據(jù)交互量控制在數(shù)據(jù)接口交換時(shí)，由數(shù)據(jù)交換系統(tǒng)雙方根據(jù)業(yè)務(wù)需求進(jìn)行數(shù)據(jù)交互量限制。9DB3308/T084—2021接口返回示例A.1信用核查接口返回示例以JSON格式返回結(jié)果數(shù)據(jù)，格式定義如下：表A.1{"creditLevel":"信用等級{}{{{DB3308/T084—2021]]}}A.2核查反饋接口返回示例核查反饋接口以JSON格式返回結(jié)果數(shù)據(jù)，格式定義如下：表A.2{}A.3核查狀態(tài)接口返回示例以JSON格式返回結(jié)果數(shù)據(jù)，格式定義如下：表A.3{}DB3308/T084—2021A.4批量核查接口返回示例以JSON格式返回結(jié)果數(shù)據(jù)，格式定義如下：表A.4{{[{[{]{[{DB3308/T084—2021[{]}{{]}}A.5批量核查反饋接口返回示例以JSON格式返回結(jié)果數(shù)據(jù)，格式定義如下：表A.5{"result":"success/error","resultMsg":"提示文字"}DB3308/T08