DB14-T 2831-2023 商務(wù)誠信公共服務(wù)平臺 信息交換接口規(guī)范

ICS03.080.99

CCSA20

14

山西省地方標(biāo)準(zhǔn)

DB14/T2831—2023

商務(wù)誠信公共服務(wù)平臺信息交換接口規(guī)范

2023-10-10發(fā)布2024-01-10實施

山西省市場監(jiān)督管理局??發(fā)布

DB14/T2831—2023

商務(wù)誠信公共服務(wù)平臺信息交換接口規(guī)范

1范圍

本文件規(guī)定了商務(wù)誠信公共服務(wù)平臺信息交換接口的術(shù)語和定義、接口類型、接口服務(wù)、技術(shù)要求、

管理要求和持續(xù)優(yōu)化。

本文件適用于商務(wù)誠信公共服務(wù)平臺與各數(shù)據(jù)提供方、數(shù)據(jù)應(yīng)用方、信用場景方之間的商務(wù)誠信信

息共享交換活動。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T22117信用基本術(shù)語

3術(shù)語和定義

GB/T22117界定的以及下列術(shù)語和定義適用于本文件。

信息交換informationexchange

信息資源在計算機網(wǎng)絡(luò)環(huán)境下從一個交換結(jié)點到其他交換結(jié)點的傳送和處理過程。

信息交換接口informationexchangeinterface

信息交換在既定交換方式的基礎(chǔ)上，約定的信息交換實體，便于信息能夠交換到約定地點、信息來

源能夠被識別、信息內(nèi)容能夠被理解。

4縮略語

下列縮略語適用于本文件。

JSON：JavaScript對象標(biāo)記（JavaScriptObjectNotation）

API：應(yīng)用程序界面（ApplicationProgramInterface）

HTTP：超文本傳送協(xié)議（HyperTextTransportProtocol）

5接口類型

數(shù)據(jù)采集類

數(shù)據(jù)采集類接口用于商務(wù)誠信公共服務(wù)平臺通過地方政務(wù)大數(shù)據(jù)中心、地方公共信用信息共享平臺、

信用信息數(shù)源單位業(yè)務(wù)系統(tǒng)、第三方機構(gòu)業(yè)務(wù)系統(tǒng)及其他商務(wù)誠信公共服務(wù)平臺等采集數(shù)據(jù)。

1

DB14/T2831—2023

數(shù)據(jù)共享類

數(shù)據(jù)共享類接口用于商務(wù)誠信公共服務(wù)平臺向接入的平臺共享商務(wù)誠信信息。常見接口示例見附錄

A。

賬號管理類

賬號管理類接口用于商務(wù)誠信公共服務(wù)平臺對接入的平臺用戶賬號和權(quán)限的管理，包括獲取公鑰接

口、修改用戶密碼接口、獲取令牌接口。

6接口服務(wù)

平臺接入

6.1.1接入申請

申請接入商務(wù)誠信公共服務(wù)平臺的單位應(yīng)制定接入方案，描述擬接入平臺的網(wǎng)絡(luò)環(huán)境、安全保障、

硬件條件、接口調(diào)用方案等信息，并向商務(wù)誠信公共服務(wù)平臺運營單位提出接入申請。申請材料包括申

請接入的單位證明文件、申請接入的理由、數(shù)據(jù)需求、用途、接入方案等信息。

6.1.2接入審核

接入方提出平臺數(shù)據(jù)接入申請后，由商務(wù)誠信公共服務(wù)平臺運營單位對申請材料及接入方案進行審

核。對于符合接入條件的單位，按時做好平臺接入技術(shù)準(zhǔn)備工作，并回復(fù)申請單位的接入申請審批結(jié)果。

6.1.3備案登記

商務(wù)誠信公共服務(wù)平臺運營單位需對接入平臺進行備案登記，記錄接入平臺的基本資料，包括平臺

名稱、用戶編號、域名、服務(wù)器IP、運營單位名稱、聯(lián)系人姓名及聯(lián)系電話等信息。

6.1.4簽訂協(xié)議

由接入平臺與商務(wù)誠信公共服務(wù)平臺運營單位簽訂用戶協(xié)議，根據(jù)業(yè)務(wù)場景確定接入方式，明確需

要調(diào)用的接口信息，共同約定數(shù)據(jù)共享的頻率、數(shù)據(jù)格式、交換方式、接口要求、有效期限、公開屬性

等內(nèi)容。

6.1.5密鑰獲取

接入平臺用戶通過商務(wù)誠信公共服務(wù)平臺注冊用戶信息，經(jīng)平臺運營單位審核后，申請接口密鑰，

申請通過后平臺下發(fā)接口訪問密鑰。獲取密鑰流程如圖1所示：

2

DB14/T2831—2023

圖1獲取密鑰流程圖

6.1.6對接調(diào)試

接入平臺用戶使用商務(wù)誠信公共服務(wù)平臺運營單位提供的平臺賬號、接口地址，對接入服務(wù)進行雙

方聯(lián)調(diào)。經(jīng)調(diào)試，實現(xiàn)接口正常調(diào)用的，即可正式上線。

6.1.7交換審計

為保證商務(wù)誠信信息交換過程的安全、質(zhì)量和時效，商務(wù)誠信公共服務(wù)平臺運營單位應(yīng)遵循相關(guān)法

律法規(guī)及國家標(biāo)準(zhǔn)、地方標(biāo)準(zhǔn)要求，對交換共享的過程進行全面記錄并進行交換審計，包括但不限于交

換接入審計、信息溯源審計。

接口調(diào)用

6.2.1數(shù)據(jù)采集類接口調(diào)用流程

商務(wù)誠信公共服務(wù)平臺可通過接口調(diào)用方式從地方政務(wù)大數(shù)據(jù)中心、地方公共信用信息共享

平臺、信用信息數(shù)源單位業(yè)務(wù)系統(tǒng)、第三方機構(gòu)業(yè)務(wù)系統(tǒng)、其他商務(wù)誠信公共服務(wù)平臺等數(shù)據(jù)提供方平

臺采集數(shù)據(jù)。接口采用HTTP通訊協(xié)議進行同步通訊，實現(xiàn)信息交換。

數(shù)據(jù)接口應(yīng)對數(shù)據(jù)報文進行加密處理，保障數(shù)據(jù)在傳輸過程中的安全。商務(wù)誠信公共服務(wù)平

臺收到數(shù)據(jù)提供方平臺返回的數(shù)據(jù)后，進行解密操作，并對解密數(shù)據(jù)生成摘要，與數(shù)據(jù)提供方平臺生成

的摘要進行比對，確保數(shù)據(jù)沒有被篡改。

商務(wù)誠信公共服務(wù)平臺根據(jù)數(shù)據(jù)采集任務(wù)要求及商務(wù)誠信信息服務(wù)需要，定期或不定期發(fā)起

數(shù)據(jù)采集請求，數(shù)據(jù)提供方平臺再根據(jù)接口約定與商務(wù)誠信公共服務(wù)平臺進行數(shù)據(jù)交互。

數(shù)據(jù)采集類接口調(diào)用流程如圖2所示：

3

DB14/T2831—2023

圖2數(shù)據(jù)采集類接口調(diào)用流程

6.2.2一般查詢接口調(diào)用流程

商務(wù)誠信公共服務(wù)平臺面向接入平臺主要通過接口調(diào)用方式提供商務(wù)誠信信息共享服務(wù)。接

口支持采用webservice/http/https通訊協(xié)議進行同步通訊，實現(xiàn)信息交換。

商務(wù)誠信公共服務(wù)平臺對外提供的數(shù)據(jù)接口通過用戶賬號管理機制來控制接入平臺用戶使用

權(quán)限。符合接入條件、完成賬號配置的接入平臺方能發(fā)起查詢請求。商務(wù)誠信公共服務(wù)平臺再按照接口

約定與接入平臺進行數(shù)據(jù)交互。

數(shù)據(jù)接口應(yīng)對數(shù)據(jù)報文進行加密處理，保障數(shù)據(jù)在傳輸過程中的安全。接入平臺收到商務(wù)誠

信公共服務(wù)平臺返回的數(shù)據(jù)后，進行解密操作，并對解密數(shù)據(jù)生成摘要，與商務(wù)誠信公共服務(wù)平臺生成

的摘要進行比對，確保數(shù)據(jù)沒有被篡改。

一般查詢接口調(diào)用服務(wù)流程如圖3所示：

4

DB14/T2831—2023

圖3一般查詢接口調(diào)用流程

6.2.3授權(quán)查詢接口調(diào)用流程

商務(wù)誠信公共服務(wù)平臺還可對外提供能反映商貿(mào)流通企業(yè)商務(wù)誠信水平的非公開信息。接入

平臺調(diào)用此類查詢接口時，須提供對應(yīng)企業(yè)的合法授權(quán)憑證，包括以下步驟：

——通過商務(wù)誠信公共服務(wù)平臺提供的接口上傳企業(yè)授權(quán)協(xié)議，保存返回的授權(quán)協(xié)議標(biāo)識；

——調(diào)用授權(quán)查詢信息接口，文件標(biāo)識作為必傳參數(shù)，經(jīng)商務(wù)誠信公共服務(wù)平臺驗證通過后，返

回查詢結(jié)果。

授權(quán)查詢接口調(diào)用流程如圖4所示：

5

DB14/T2831—2023

圖4授權(quán)查詢接口調(diào)用流程

7技術(shù)要求

接口基本規(guī)范

7.1.1商務(wù)誠信公共服務(wù)平臺提供API接口服務(wù)，遵循RESTful設(shè)計風(fēng)格，與接入平臺的數(shù)據(jù)交換格

式采用Json格式。接口調(diào)用與返回參數(shù)可參照附錄A的接口示例。

7.1.2數(shù)據(jù)采集類接口可在雙方協(xié)商一致的基礎(chǔ)上，遵循數(shù)據(jù)提供方平臺的接口規(guī)范要求。

6

DB14/T2831—2023

系統(tǒng)級參數(shù)約定

表1中系統(tǒng)級參數(shù)是由商務(wù)誠信公共服務(wù)平臺系統(tǒng)定義的，各接入平臺需要支持這些參數(shù)以便接入

該平臺提供開放接口。商務(wù)誠信公共服務(wù)平臺采用應(yīng)用授權(quán)認證接口方式，接入平臺調(diào)用平臺接口時需

提供密鑰、賬戶和密碼。

表1系統(tǒng)級參數(shù)說明

參數(shù)名類型是否必需描述

accessid字符串是用戶申請接口時，平臺自動分配到的應(yīng)用唯一標(biāo)識

username字符串是在平臺注冊賬戶時的唯一用戶名

pwd字符串是授權(quán)用戶登錄系統(tǒng)的密碼

應(yīng)用級參數(shù)的通用約定

各業(yè)務(wù)系統(tǒng)應(yīng)遵守API平臺系統(tǒng)規(guī)范中應(yīng)用級通用參數(shù)的約定。應(yīng)用及參數(shù)說明見表2。

表2應(yīng)用級參數(shù)說明

參數(shù)名類型是否必需描述

pagenoint是用于支持分頁的api，默認為1，表示第幾頁

pagesizeint是用于支持分頁的api，表示每頁返回多少條數(shù)據(jù)

8管理要求

總體要求

商務(wù)誠信公共服務(wù)平臺運營單位負責(zé)對接口的設(shè)計、開發(fā)、啟動、修改、停用、刪除進行全流程管

理。

監(jiān)測檢查

8.2.1商務(wù)誠信公共服務(wù)平臺運營單位對接口服務(wù)進行定期監(jiān)測，定期對問題進行匯總分析，檢查發(fā)

現(xiàn)錯誤或問題及時處理，必要時向接入平臺用戶協(xié)商確定解決方案。

8.2.2監(jiān)測檢查的內(nèi)容包括：

——更新頻率，按照相關(guān)協(xié)議檢查平臺是否與外部系統(tǒng)進行數(shù)據(jù)共享；

——數(shù)據(jù)質(zhì)量，商務(wù)誠信公共服務(wù)平臺運營單位每月不低于一次監(jiān)測數(shù)據(jù)質(zhì)量，包括提供的數(shù)據(jù)

是否根據(jù)協(xié)議規(guī)定采集、共享；數(shù)據(jù)格式是否規(guī)范；數(shù)據(jù)內(nèi)容是否完整；數(shù)據(jù)是否準(zhǔn)確真實

等。

安全控制

商務(wù)誠信公共服務(wù)平臺運營單位應(yīng)從技術(shù)和管理兩個方面加強系統(tǒng)安全和數(shù)據(jù)安全，實施嚴(yán)格的用

戶認證和權(quán)限控制策略，滿足對信息安全保護及信息保密需求。

9持續(xù)優(yōu)化

7

DB14/T2831—2023

商務(wù)誠信公共服務(wù)平臺運營單位應(yīng)根據(jù)平臺發(fā)展定位及服務(wù)需求，結(jié)合接口調(diào)用實際情況，定期優(yōu)

化調(diào)整平臺接口規(guī)劃，提升接口性能及接口數(shù)據(jù)質(zhì)量，適應(yīng)商務(wù)誠信公共服務(wù)平臺及各相關(guān)平臺對商務(wù)

誠信信息共享及應(yīng)用要求。

8

DB14/T2831—2023

A

A

附錄A

（資料性）

接口示例

A.1獲取單個企業(yè)誠信等級接口

根據(jù)統(tǒng)一社會信用代碼獲取企業(yè)的誠信等級，誠信等級分為5個級別，分別為AA，A，B，C，D。

——接口標(biāo)識：getEnterpriseGrade；

——請求方式：POST；

——請求參數(shù)如表A.1所示，返回參數(shù)如表A.2所示。

表A.1獲取單個企業(yè)誠信等級接口請求參數(shù)說明

參數(shù)名類型必填示例值描述

accessidstring是訪問接口的密鑰

usernamestring是用戶賬戶

pwdstring是密碼

uniscIdstring是企業(yè)統(tǒng)一社會信用代碼

表A.2獲取單個企業(yè)誠信等級接口返回參數(shù)說明

參數(shù)名類型示例值描述

msgstring獲取企業(yè)誠信等級成功接口調(diào)用結(jié)果描述

resultint調(diào)用接口，成功與否，1代表成功，0代表失敗。

uniscIdstring企業(yè)統(tǒng)一社會信用代碼

enterpriseNamestring企業(yè)名稱

assessGradestring企業(yè)的誠信等級

示例：

{

msg:’獲取企業(yè)誠信等級成功’,

result:1,

data:{

uniscId:’91140107×××××××6F’,

enterpriseName:’太原市××××××科技有限公司’,

assessGrade:‘A’

}

}

A.2批量獲取企業(yè)誠信等級接口

批量獲取企業(yè)的誠信等級，根據(jù)參數(shù)當(dāng)前頁碼和頁碼的大小獲取。

——接口標(biāo)識：getEnterpriseGrades

——請求方式：POST

——請求參數(shù)如表A.3所示，返回參數(shù)如表A.4所示：

9

DB14/T2831—2023

表A.3批量獲取企業(yè)誠信等級接口請求參數(shù)說明

參數(shù)名類型必填示例值描述

accessidstring是訪問接口的密鑰

usernamestring是用戶賬戶

pwdstring是密碼

pagenoint是當(dāng)前獲取數(shù)據(jù)的頁

pagesizeint是每一頁大小，最大不得超過1000

表A.4批量獲取企業(yè)誠信等級接口返回參數(shù)說明

參數(shù)名類型示例值描述

msgstring獲取企業(yè)誠信等級成功接口調(diào)用結(jié)果描述

resultint調(diào)用接口，成功與否，1代表成功，0代表失敗。

uniscIdstring企業(yè)統(tǒng)一社會信用代碼

enterpriseNamestring企業(yè)名稱

assessGradestring企業(yè)的誠信等級

示例：

{

msg:’獲取企業(yè)誠信等級成功’,

result:1,

data:{

pageno:10,

count:1700000,

pagesize:1000,

companyList:[

{

uniscId:’92140107××××××1J’,

enterpriseName:’××××××’,

assessGrade:‘A’

},

{

uniscId:’92140107××××××1K’,

enterpriseName:’××××××’,

assessGrade:‘B’

},

………,

{

uniscId:’92140107×××××××56’,

enterpriseName:’××××××’,

assessGrade:‘AA’

}

]

10

DB14/T2831—2023

}

}

A.3授權(quán)獲取公共資源交易記錄接口

以公共資源交易記錄查詢接口為例，對接口文檔進行說明。根據(jù)組織機構(gòu)統(tǒng)一社會信用代碼獲取企

業(yè)的公共資源交易記錄。該接口屬于授權(quán)查詢接口。

——接口標(biāo)識：getPublicResourcesTrading；

——請求方式：POST；

——請求參數(shù)說明和返回參數(shù)說明分別見表A.5、表A.6。

表A.5公共資源交易記錄查詢接口請求參數(shù)

參數(shù)名類型必填示例值描述

accessidstring是訪問接口的密鑰

usernamestring是用戶賬戶

pwdstring是密碼

uniscIdstring是企業(yè)統(tǒng)一社會信用代碼

licenseIDstring是企業(yè)授權(quán)協(xié)議標(biāo)識（回傳接口返回）

表A.6公共資源交易記錄查詢接口返回參數(shù)

參數(shù)名類型示例值描述

msgstring獲取公共資源交易記錄成功接口調(diào)用結(jié)果描述

resultint調(diào)用接口，成功與否，1代表成功，0代表失敗。

dataarray交易信息列表

交易類型，包含工程建設(shè)、政府采購、土地、礦業(yè)、

typestring