公共信用信息 共享技術(shù)規(guī)范DB41-T 2335-2022

ICS03.080.99

CCSA20

41

河南省地方標(biāo)準(zhǔn)

DB41/T2335—2022

公共信用信息共享技術(shù)規(guī)范

2022-10-17發(fā)布2023-01-16實(shí)施

河南省市場監(jiān)督管理局發(fā)布

DB41/T2335—2022

目次

前言.................................................................................II

1范圍...............................................................................1

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

3術(shù)語和定義.........................................................................1

4縮略語.............................................................................2

5共享體系...........................................................................2

6文件共享...........................................................................4

7數(shù)據(jù)庫共享.........................................................................5

8服務(wù)接口共享.......................................................................7

附錄A（資料性）服務(wù)接口模板.........................................................9

參考文獻(xiàn).............................................................................10

I

DB41/T2335—2022

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

本文件由河南省發(fā)展和改革委員會(huì)提出并歸口。

本文件起草單位：河南省營商環(huán)境和社會(huì)信用建設(shè)中心、河南省平臺(tái)經(jīng)濟(jì)發(fā)展指導(dǎo)中心、河南省交

通運(yùn)輸調(diào)度指揮中心、河南省生態(tài)環(huán)境監(jiān)測和安全中心、河南省自然資源綜合保障中心、河南省政務(wù)大

數(shù)據(jù)中心、鄭州市信息中心、開封市信用信息中心、河南榕基信息技術(shù)有限公司、河南省中原信用管理

研究院。

本文件主要起草人：劉孟旭、時(shí)興華、王利娟、劉洋、趙滿滿、趙衛(wèi)利、宋高磊、練凱迪、李冉、

任鵬、王陽、王豐亞、齊彥欣、張浩磊、梁永強(qiáng)、劉恒利、肖中東、李建豪。

II

DB41/T2335—2022

公共信用信息共享技術(shù)規(guī)范

1范圍

本文件規(guī)定了公共信用信息的共享體系、文件共享、數(shù)據(jù)庫共享和服務(wù)接口共享。

本文件適用于各級(jí)各類信用平臺(tái)系統(tǒng)及第三方機(jī)構(gòu)業(yè)務(wù)系統(tǒng)之間的公共信用信息共享。

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

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

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

文件。

GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法

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

3術(shù)語和定義

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

3.1

信用主體

參與信用活動(dòng)的個(gè)人或組織。

[來源：GB/T22117—2018,定義2.4]

3.2

信用信息

個(gè)人或組織在社會(huì)與經(jīng)濟(jì)活動(dòng)中產(chǎn)生的與信用有關(guān)的記錄，以及與評(píng)價(jià)其信用價(jià)值相關(guān)的各類信息。

[來源：GB/T22117—2018,定義2.22]

3.3

公共信用信息

依法行使公共職能的部門履行職責(zé)、提供服務(wù)過程產(chǎn)生的有關(guān)各類主體的信用信息。

注：依法行使公共職能的部門包括行政機(jī)關(guān)、司法機(jī)關(guān)以及依法行使公共管理(服務(wù))職能的企、事業(yè)單位和社會(huì)組

織等。

[來源：GB/T39444—2020,定義3.1]

3.4

結(jié)構(gòu)化數(shù)據(jù)

一種數(shù)據(jù)表示形式，按此種形式，由數(shù)據(jù)元素匯集而成的每個(gè)記錄的結(jié)構(gòu)都是一致的并且可以使用

關(guān)系模型予以有效描述的數(shù)據(jù)。

[來源：GB/T35295—2017,定義2.2.13]

3.5

半結(jié)構(gòu)化數(shù)據(jù)

不具備結(jié)構(gòu)化數(shù)據(jù)嚴(yán)格的存儲(chǔ)結(jié)構(gòu)，但可以使用標(biāo)簽或其他形式的標(biāo)記方法標(biāo)識(shí)層次結(jié)構(gòu)的數(shù)據(jù)。

1

DB41/T2335—2022

3.6

非結(jié)構(gòu)化數(shù)據(jù)

不具有預(yù)定義模型或未以預(yù)定義方式組織的數(shù)據(jù)。

[來源：GB/T35295—2017,定義2.1.25]

4縮略語

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

XML:可擴(kuò)展標(biāo)記語言(ExtensibleMarkupLanguage)

JSON:JavaScript對(duì)象表示法(JavaScriptObjectNotation)

CSV：逗號(hào)分隔值（Comma-SeparatedValues）

HTTP:超文本傳輸協(xié)議(HyperTextTransferProtocol)

HTTPS:超文本傳輸安全協(xié)議(HyperTextTransferProtocoloverSecureSocketLayer)

REST:表征狀態(tài)轉(zhuǎn)移(RepresentationalStateTransfer)

SOAP:簡單對(duì)象訪問協(xié)議(SimpleObjectAccessProtocol)

WSDL:網(wǎng)絡(luò)服務(wù)描述語言(WebServicesDescriptionLanguage)

SM2：SM2橢圓曲線公鑰密碼算法(PublicKeyCryptographicAlgorithmSM2BasedonElliptic

Curves)

SM3：SM3密碼雜湊算法(SM3cryptographicHashalgorithm)

SM4：SM4分組密碼算法(SM4blockcipheralgorithm)

5共享體系

5.1共享原則

公共信用信息的歸集共享應(yīng)當(dāng)遵循合法、客觀、及時(shí)、必要、安全的原則，不應(yīng)侵犯國家秘密、商

業(yè)秘密和個(gè)人隱私。

5.2共享方式

5.2.1文件共享

公共信用信息通過文件傳送服務(wù)，實(shí)現(xiàn)文件類數(shù)據(jù)共享，適用于非結(jié)構(gòu)化、半結(jié)構(gòu)化數(shù)據(jù)共享。

5.2.2數(shù)據(jù)庫共享

公共信用信息通過數(shù)據(jù)交換服務(wù)，實(shí)現(xiàn)數(shù)據(jù)庫到數(shù)據(jù)庫的數(shù)據(jù)共享，適用于結(jié)構(gòu)化、大批量、周期

性的數(shù)據(jù)共享。

5.2.3服務(wù)接口共享

公共信用信息通過發(fā)布的服務(wù)接口，實(shí)現(xiàn)數(shù)據(jù)實(shí)時(shí)訪問或傳送，適用于少量數(shù)據(jù)實(shí)時(shí)訪問或傳送。

5.3共享屬性

2

DB41/T2335—2022

共享屬性分為公開公示、政務(wù)共享、授權(quán)查詢?nèi)齻€(gè)類別。公開公示類公共信用信息指依照法律、法

規(guī)、規(guī)章規(guī)定應(yīng)當(dāng)公開發(fā)布的公共信用信息。政務(wù)共享類公共信用信息指國家機(jī)關(guān)、法律法規(guī)授權(quán)的具

有管理公共事務(wù)職能的組織以及群團(tuán)組織，在依法履行職責(zé)過程中可以共享使用的公共信用信息。授權(quán)

查詢類公共信用信息指經(jīng)信用主體授權(quán)可以查詢，并按照約定用途使用的公共信用信息。

5.4關(guān)聯(lián)標(biāo)識(shí)

公共信用信息共享的關(guān)聯(lián)匹配標(biāo)識(shí)應(yīng)符合以下要求：

a)自然人公共信用信息的共享以居民身份證號(hào)碼作為關(guān)聯(lián)匹配的標(biāo)識(shí)；無居民身份證號(hào)碼的，

以其他有效身份證件號(hào)碼作為關(guān)聯(lián)匹配的標(biāo)識(shí)；

b)法人和非法人組織公共信用信息的共享以統(tǒng)一社會(huì)信用代碼作為關(guān)聯(lián)匹配的唯一標(biāo)識(shí)。

5.5共享體系框架

公共信用信息共享體系框架由省信用信息共享平臺(tái)、省有關(guān)部門信用信息系統(tǒng)、省轄市信用信息共

享平臺(tái)和第三方機(jī)構(gòu)業(yè)務(wù)系統(tǒng)組成，通過文件共享、數(shù)據(jù)庫共享、服務(wù)接口共享三種方式實(shí)現(xiàn)公共信用

信息共享。

公共信用信息共享體系框架見圖1。

圖1公共信用信息共享體系框架圖

3

DB41/T2335—2022

5.6共享機(jī)制

數(shù)據(jù)提供方和數(shù)據(jù)接收方應(yīng)建立公共信用信息共享長效運(yùn)行機(jī)制，規(guī)范共享流程、數(shù)據(jù)約束、更新

機(jī)制、校驗(yàn)機(jī)制、異常處理等技術(shù)要求。

公共信用信息共享機(jī)制見圖2。

圖2公共信用信息共享機(jī)制圖

6文件共享

6.1共享流程

文件共享流程應(yīng)包含以下內(nèi)容：

a)確定共享方案：數(shù)據(jù)提供方與數(shù)據(jù)接收方約定文件共享的資源名稱、文件格式、更新周期等

信息。半結(jié)構(gòu)化數(shù)據(jù)提供數(shù)據(jù)結(jié)構(gòu)及數(shù)據(jù)資源描述信息；

b)約定共享機(jī)制：雙方約定文件共享的更新方式、校驗(yàn)機(jī)制以及異常處理反饋機(jī)制；

c)實(shí)施文件共享：通過可靠文件傳送服務(wù)完成數(shù)據(jù)文件的傳送；

4

DB41/T2335—2022

d)確認(rèn)完整性：數(shù)據(jù)接收方按約定的校驗(yàn)機(jī)制驗(yàn)證已接受文件是否存在丟失、損壞等問題，確

認(rèn)已接收文件完整性和數(shù)據(jù)完整性；

e)反饋共享結(jié)果：如確認(rèn)共享文件準(zhǔn)確無誤，反饋成功信息；如校驗(yàn)失敗則反饋失敗信息，重

新進(jìn)行文件傳輸。

6.2數(shù)據(jù)約束

文件共享的數(shù)據(jù)約束應(yīng)符合以下要求：

a)字符集默認(rèn)采用UTF-8；

b)漢字使用中文半角,英文字母、數(shù)字和符號(hào)使用英文半角；

c)自然人身份證號(hào)碼或其他有效身份證件號(hào)碼、法人和非法人組織統(tǒng)一社會(huì)信用代碼設(shè)置為字

符類型；

d)非結(jié)構(gòu)化數(shù)據(jù)文件單個(gè)文件大小不超過約定上限；

e)半結(jié)構(gòu)化數(shù)據(jù)文件單個(gè)文件大小不超過約定上限，超出單個(gè)文件大小上限的，拆分成多個(gè)文

件，且文件名包含日期、時(shí)間或自增長序列等表示數(shù)據(jù)邏輯順序的信息；

f)過濾掉XML或JSON數(shù)據(jù)中的控制字符；

g)XML數(shù)據(jù)中的特殊字符使用CDATA標(biāo)簽將包含特殊字符的字符串封裝起來或使用XML轉(zhuǎn)義序列

表示；

h)JSON數(shù)據(jù)中的特殊字符使用轉(zhuǎn)義序列表示；

i)數(shù)據(jù)項(xiàng)內(nèi)容為空時(shí)，保留必要的結(jié)構(gòu)信息保持?jǐn)?shù)據(jù)結(jié)構(gòu)完整性，XML或JSON數(shù)據(jù)保留數(shù)據(jù)項(xiàng)

對(duì)應(yīng)的節(jié)點(diǎn)，CSV格式文件保留數(shù)據(jù)項(xiàng)對(duì)應(yīng)的分隔符。

6.3更新機(jī)制

數(shù)據(jù)文件更新應(yīng)符合以下要求：

a)按照約定的頻次和方式進(jìn)行更新；

b)采用增量更新的，按照約定的增量數(shù)據(jù)文件順序進(jìn)行更新；

c)數(shù)據(jù)提供方按照約定時(shí)間和流程更新文件；

d)數(shù)據(jù)接收方接收更新文件并按照約定的規(guī)則更新信息，增量更新嚴(yán)格按順序依次更新信息。

6.4校驗(yàn)機(jī)制

文件共享校驗(yàn)機(jī)制應(yīng)包含以下內(nèi)容：

a)提供確認(rèn)共享文件完整性的校驗(yàn)機(jī)制和途徑，驗(yàn)證共享文件是否存在丟失、損壞等問題；

b)數(shù)據(jù)文件提供確認(rèn)數(shù)據(jù)完整性的校驗(yàn)機(jī)制和途徑，驗(yàn)證是否存在文件解析錯(cuò)誤、數(shù)據(jù)結(jié)構(gòu)損

壞、違反數(shù)據(jù)約束規(guī)則等問題。

6.5異常處理

文件共享異常處理機(jī)制應(yīng)包含以下內(nèi)容：

a)建立損壞、文件丟失等文件共享問題的發(fā)現(xiàn)、驗(yàn)證和處置機(jī)制；

b)建立半結(jié)構(gòu)化數(shù)據(jù)文件解析錯(cuò)誤、數(shù)據(jù)結(jié)構(gòu)損壞、違反數(shù)據(jù)約束規(guī)則等問題的發(fā)現(xiàn)、驗(yàn)證和

處置機(jī)制。

7數(shù)據(jù)庫共享

5

DB41/T2335—2022

7.1共享流程

數(shù)據(jù)庫共享流程應(yīng)包含以下內(nèi)容：

a)確定共享方案：數(shù)據(jù)提供方和數(shù)據(jù)接收方約定共享交換數(shù)據(jù)的結(jié)構(gòu)、更新周期、更新方式等

內(nèi)容；

b)提供數(shù)據(jù)源信息：數(shù)據(jù)提供方提供數(shù)據(jù)庫類型、數(shù)據(jù)庫地址、服務(wù)端口、用戶名、密碼、共

享實(shí)體名稱和定義腳本以及相關(guān)數(shù)據(jù)字典等信息；

c)初始化數(shù)據(jù)庫：數(shù)據(jù)接收方依據(jù)數(shù)據(jù)提供方提供的信息完成數(shù)據(jù)庫表結(jié)構(gòu)初始化；

d)約定共享機(jī)制：雙方約定數(shù)據(jù)庫更新方式、校驗(yàn)機(jī)制以及異常處理反饋機(jī)制；

e)實(shí)施數(shù)據(jù)共享：數(shù)據(jù)提供方按約定的數(shù)據(jù)更新方式推送數(shù)據(jù)，數(shù)據(jù)接收方接收數(shù)據(jù)，完成數(shù)

據(jù)交換；

f)驗(yàn)證數(shù)據(jù)完整性：數(shù)據(jù)接收方按約定的數(shù)據(jù)校驗(yàn)規(guī)則驗(yàn)證數(shù)據(jù)完整性；

g)反饋共享結(jié)果：數(shù)據(jù)接收方確認(rèn)共享數(shù)據(jù)準(zhǔn)確無誤，反饋成功信息；如校驗(yàn)失敗則反饋失敗

信息，重新進(jìn)行數(shù)據(jù)傳輸。

7.2數(shù)據(jù)約束

數(shù)據(jù)庫共享數(shù)據(jù)應(yīng)符合以下要求：

a)字符集默認(rèn)采用UTF-8或雙方約定的字符集；

b)數(shù)據(jù)庫表結(jié)構(gòu)、數(shù)據(jù)類型、約束規(guī)則保持一致；

c)刪除標(biāo)識(shí)、交換標(biāo)識(shí)位、時(shí)間戳等保持一致，并按業(yè)務(wù)邏輯和約定規(guī)則更新；

d)異構(gòu)數(shù)據(jù)庫進(jìn)行數(shù)據(jù)類型、數(shù)據(jù)格式的映射和轉(zhuǎn)換時(shí)保證數(shù)據(jù)準(zhǔn)確性和完整性。

7.3更新機(jī)制

7.3.1全量更新

全量更新應(yīng)符合以下要求：

a)數(shù)據(jù)庫表具有唯一主鍵；

b)采用刪除標(biāo)識(shí)位、刪除表等方式確保刪除信息可以準(zhǔn)確同步；

c)公共信用信息記錄的創(chuàng)建和更新時(shí)間與業(yè)務(wù)系統(tǒng)產(chǎn)生和變更時(shí)間保持一致。

7.3.2基于時(shí)間戳更新

基于時(shí)間戳的數(shù)據(jù)更新應(yīng)符合以下要求：

a)數(shù)據(jù)庫表具有唯一主鍵；

b)數(shù)據(jù)庫表設(shè)置時(shí)間戳字段，時(shí)間戳字段數(shù)值為北京時(shí)間，精度精確到毫秒并按更新時(shí)間保持

嚴(yán)格遞增；

c)刪除數(shù)據(jù)的，設(shè)置刪除標(biāo)識(shí)字段，標(biāo)識(shí)邏輯刪除；

d)添加、修改數(shù)據(jù)時(shí)同步更新時(shí)間戳，刪除數(shù)據(jù)時(shí)同步更新刪除標(biāo)識(shí)和時(shí)間戳。

7.3.3基于數(shù)據(jù)交換標(biāo)識(shí)更新

基于數(shù)據(jù)交換標(biāo)識(shí)的數(shù)據(jù)更新應(yīng)符合以下要求：

a)數(shù)據(jù)庫表具有唯一主鍵；

b)數(shù)據(jù)庫表設(shè)置數(shù)據(jù)交換標(biāo)識(shí)字段；

6

DB41/T2335—2022

c)刪除數(shù)據(jù)的，設(shè)置刪除標(biāo)識(shí)字段，標(biāo)識(shí)邏輯刪除；

d)更新數(shù)據(jù)時(shí)同步更新數(shù)據(jù)交換標(biāo)識(shí)，刪除數(shù)據(jù)時(shí)同步更新數(shù)據(jù)交換標(biāo)識(shí)和刪除標(biāo)識(shí)。

7.3.4基于觸發(fā)器更新

基于觸發(fā)器的數(shù)據(jù)更新應(yīng)符合以下要求：

a)數(shù)據(jù)庫表具有唯一主鍵；

b)具有創(chuàng)建、修改和刪除觸發(fā)器權(quán)限。

7.4校驗(yàn)機(jī)制

數(shù)據(jù)庫共享校驗(yàn)機(jī)制應(yīng)符合以下要求：

a)按約定的數(shù)據(jù)標(biāo)準(zhǔn)建立主鍵約束、非空約束、默認(rèn)值約束、檢查約束、外鍵約束等數(shù)據(jù)庫約

束機(jī)制；

b)按照業(yè)務(wù)規(guī)則建立數(shù)據(jù)準(zhǔn)確性和完整性校驗(yàn)機(jī)制；

c)提供抗抵賴服務(wù)的，通過雜湊算法、數(shù)字簽名等密碼技術(shù)建立數(shù)據(jù)的準(zhǔn)確性和完整性校驗(yàn)機(jī)

制。

7.5異常處理

數(shù)據(jù)庫共享異常處理應(yīng)包含以下內(nèi)容：

a)提供應(yīng)對(duì)服務(wù)中斷、網(wǎng)絡(luò)異常等問題的處置方式；

b)提供應(yīng)對(duì)數(shù)據(jù)庫約束不一致、操作權(quán)限不足等問題的處置方式；

c)提供應(yīng)對(duì)數(shù)據(jù)類型不匹配、字符集不一致等問題的處置方式；

d)提供應(yīng)對(duì)更新信息丟失、數(shù)據(jù)不一致等問題的處置方式。

8服務(wù)接口共享

8.1共享流程

服務(wù)接口共享流程應(yīng)包含以下內(nèi)容：

a)確定共享方案：數(shù)據(jù)提供方提供服務(wù)接口描述信息，包括但不限于接口名稱、接口地址、接

口描述等，服務(wù)接口描述參見附錄A；

b)開發(fā)調(diào)用程序：數(shù)據(jù)接收方根據(jù)服務(wù)接口信息開發(fā)相應(yīng)服務(wù)接口調(diào)用程序；

c)聯(lián)合調(diào)試接口：數(shù)據(jù)接收方與數(shù)據(jù)提供方聯(lián)合調(diào)試服務(wù)接口，驗(yàn)證網(wǎng)絡(luò)通訊、服務(wù)性能、數(shù)

據(jù)完整性等；

d)確認(rèn)服務(wù)上線：試運(yùn)行后，數(shù)據(jù)接收方與數(shù)據(jù)提供方共同確認(rèn)共享服務(wù)正式上線。

8.2技術(shù)要點(diǎn)

服務(wù)接口技術(shù)要點(diǎn)應(yīng)符合以下要求：

a)服務(wù)傳輸協(xié)議符合HTTP/HTTPS1.0/1.1要求；

b)服務(wù)消息協(xié)議采用WebService服務(wù)或REST服務(wù)，WebService服務(wù)消息封裝符合SOAP1.1/1.2

標(biāo)準(zhǔn)；REST服務(wù)消息封裝符合HTTP1.0/1.1要求；

c)服務(wù)描述的內(nèi)容格式符合WSDL1.1、SOAP1.1/1.2要求；

7

DB41/T2335—2022

d)涉及政務(wù)共享類或授權(quán)查詢類信息的，服務(wù)接口采用密碼技術(shù)保障信息安全，優(yōu)先采用SM2、

SM3、SM4等國產(chǎn)密碼算法；

e)請(qǐng)求數(shù)據(jù)和返回?cái)?shù)據(jù)采用XML或JSON格式。

8.3數(shù)據(jù)約束

服務(wù)接口數(shù)據(jù)約束應(yīng)符合以下要求：

a)報(bào)文頭信息具有默認(rèn)結(jié)構(gòu)，同時(shí)支持自定義報(bào)文頭；

b)響應(yīng)報(bào)文包含響應(yīng)狀態(tài)、響應(yīng)時(shí)間戳、返回?cái)?shù)據(jù)正文以及自定義擴(kuò)展內(nèi)容；

c)字符集默認(rèn)采用UTF-8；

d)漢字使用中文半角，英文字母、數(shù)字和符號(hào)使用英文半角；

e)請(qǐng)求數(shù)據(jù)和返回?cái)?shù)據(jù)采用XML格式或JSON格式；

f)過濾掉XML或JSON數(shù)據(jù)中的控制字符；

g)XML數(shù)據(jù)中的特殊字符使用CDATA標(biāo)簽將包含特殊字符的字符串封裝起來或使用XML轉(zhuǎn)義序列

表示；

h)JSON數(shù)據(jù)中的特殊字符使用轉(zhuǎn)義序列表示；

i)數(shù)據(jù)項(xiàng)內(nèi)容為空時(shí)，保留數(shù)據(jù)項(xiàng)對(duì)應(yīng)的節(jié)點(diǎn)；

j)各字段若無特別說明均為字符型；

k)數(shù)值型數(shù)據(jù)明確精度和單位，日期型數(shù)據(jù)默認(rèn)精確到日，時(shí)間類型數(shù)據(jù)默認(rèn)精確到秒，時(shí)間

戳類型數(shù)據(jù)默認(rèn)精確到毫秒；

l)日期和時(shí)間表示符合GB/T7408規(guī)定。

8.4服務(wù)更新

數(shù)據(jù)提供方對(duì)服務(wù)接口進(jìn)行更新時(shí)應(yīng)符合以下要求：

a)提前進(jìn)行服務(wù)接口更新備案，通知服務(wù)接口的計(jì)劃停止時(shí)間、重新啟動(dòng)時(shí)間、變更內(nèi)容等；

b)保持向下兼容，輸入、輸出參數(shù)保持不變；

c)不能保持向下兼容的，原服務(wù)接口在約定時(shí)間內(nèi)保持服務(wù)；

d)服務(wù)更新避開工作時(shí)間和服務(wù)接口調(diào)用高峰期。

8.5異常處理

服務(wù)接口異常處理應(yīng)包含以下內(nèi)容：

a)提供應(yīng)對(duì)服務(wù)響應(yīng)異常的處置方式，異常處置狀態(tài)碼默認(rèn)采用HTTP狀態(tài)碼表示；

b)提供應(yīng)對(duì)數(shù)據(jù)丟失、數(shù)據(jù)錯(cuò)誤、違反數(shù)據(jù)規(guī)范等問題的處置方式；

c)數(shù)據(jù)接收方及時(shí)獲取異常情況，按約定規(guī)則進(jìn)行處置并反饋異常。

8

DB41/T2335—2022

A

A

附錄A

（資料性）

服務(wù)接口模板

服務(wù)接口描述模板見表A.1。

表A.1服務(wù)接口描述模板

接口概述描述出接口的提供方和功能

采用中文名稱，由提供方名稱、信息資源名稱和接口分類三部分組成。提供方名稱宜使用國家規(guī)定

接口名稱

的部門簡稱

接口方式WebService或REST

接口地址https://IP:Port/Path

接口授權(quán)數(shù)據(jù)提供方授權(quán)要求

接口方法接口方法名

請(qǐng)求內(nèi)容類型application/json;charset=utf-8

請(qǐng)求格式填寫服務(wù)接口請(qǐng)求數(shù)據(jù)格式，如XML或JSON

返回格式填寫服務(wù)接口返回?cái)?shù)據(jù)格式，如XML或JSON

針對(duì)每個(gè)接口方法，給出參數(shù)名、參數(shù)說明、類型、約束等請(qǐng)求參數(shù)信息

請(qǐng)求參數(shù)

變量名稱字段名稱數(shù)據(jù)類型是否允許為空字段說明

參數(shù)1

參數(shù)2

……

參數(shù)示例

針對(duì)每個(gè)接口方法，給出返回值格式等輸出信息

返回?cái)?shù)據(jù)

字段名稱數(shù)據(jù)類型描述

參數(shù)1

參數(shù)2

……

參數(shù)示例

9

DB41/T2335—2022

參考文獻(xiàn)

[1]GB11643公民身份號(hào)碼

[2]GB/T21062.2政務(wù)信息資源交換體系第2部分:技術(shù)要求

[3]GB32100法人和其他組織統(tǒng)一社會(huì)信用代碼編碼規(guī)則

[4]GB/T35295—2017信息技術(shù)大數(shù)據(jù)術(shù)語

[5]GB/T39440公共信用信息資源目錄編制指南

[6]GB/T39441公共信用信息分類與編碼規(guī)范

[7]GB/T39442公共信用信息資源標(biāo)識(shí)規(guī)則

[8]GB/T39443公共信用信息交換方式及接口規(guī)范

[9]GB/T39444—2020公共信用信息標(biāo)準(zhǔn)總體架構(gòu)

10

DB41/T2335—2022

目次

前言.................................................................................II

1范圍...............................................................................1

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

3術(shù)語和定義.........................................................................1

4縮略語.............................................................................2

5共享體系...........................................................................2

6文件共享...........................................................................4

7數(shù)據(jù)庫共享.........................................................................5

8服務(wù)接口共享.......................................................................7

附錄A（資料性）服務(wù)接口模板.........................................................9

參考文獻(xiàn).............................................................................10