ICS35.240.01

CCSL67

!7,



DB32/T4608.2—2023

公共數(shù)據(jù)管理規(guī)范

第2部分：數(shù)據(jù)共享交換

Specificationforthemanagementofpublicdata—

Part2：Datasharingandexchanging

2023-12-01發(fā)布2024-01-01實(shí)施

江蘇省市場(chǎng)監(jiān)督管理局發(fā)布

中國(guó)標(biāo)準(zhǔn)出版社出版

DB32/T4608.2—2023

目次

前言……………………………Ⅲ

引言……………………………Ⅳ

1范圍…………………………1

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

3術(shù)語(yǔ)和定義…………………1

4縮略語(yǔ)………………………2

5職責(zé)分工……………………2

6交換體系……………………3

7數(shù)據(jù)接入……………………5

8數(shù)據(jù)歸集……………………5

9數(shù)據(jù)交換……………………9

10數(shù)據(jù)安全…………………10

附錄A（資料性）接入申請(qǐng)表………………12

附錄B（資料性）庫(kù)表數(shù)據(jù)推送示例………………………13

附錄C（資料性）服務(wù)接口狀態(tài)碼代碼集…………………14

附錄D（規(guī)范性）服務(wù)接口文檔要求………………………16

參考文獻(xiàn)………………………18

Ⅰ

DB32/T4608.2—2023

前言

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

起草。

本文件是DB32/T4608《公共數(shù)據(jù)管理規(guī)范》的第2部分。DB32/T4608已經(jīng)發(fā)布了以下部分：

——第1部分：數(shù)據(jù)分類分級(jí)；

——第2部分：數(shù)據(jù)共享交換。

請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。

本文件由江蘇省政務(wù)服務(wù)管理辦公室提出歸口并組織實(shí)施。

本文件起草單位：江蘇省大數(shù)據(jù)管理中心、江蘇省質(zhì)量和標(biāo)準(zhǔn)化研究院。

本文件主要起草人：吳中東、何正慶、李萍、周成兵、朱春琴、付勍、魏房忠、孫毅、曹銀美、曹磊、

花凌鋒、丁浩、劉曉紅、王維。

Ⅲ

DB32/T4608.2—2023

引言

公共數(shù)據(jù)是公共管理和服務(wù)機(jī)構(gòu)為履行法定職責(zé)、提供公共服務(wù)收集、產(chǎn)生的，以電子或者其他方式

記錄、保存的具有公共使用價(jià)值的信息記錄。規(guī)范公共數(shù)據(jù)管理、保障公共數(shù)據(jù)安全，對(duì)推動(dòng)數(shù)字政府建

設(shè)、提升政府治理能力和公共服務(wù)水平具有重要意義。DB32/T4608《公共數(shù)據(jù)管理規(guī)范》旨在確立公共

數(shù)據(jù)管理活動(dòng)中分類分級(jí)和共享交換的準(zhǔn)則，擬由兩個(gè)部分構(gòu)成。

——第1部分：數(shù)據(jù)分類分級(jí)。目的在于確立公共數(shù)據(jù)分類和分級(jí)的規(guī)則，為數(shù)據(jù)應(yīng)用和保護(hù)提供

重要指導(dǎo)。

——第2部分：數(shù)據(jù)共享交換。目的在于指導(dǎo)開(kāi)展省、市公共數(shù)據(jù)共享交換平臺(tái)建設(shè)、管理和對(duì)接，

規(guī)范各級(jí)公共管理和服務(wù)機(jī)構(gòu)的數(shù)據(jù)接入、歸集、交換共享等工作，建立健全全省一體化公共數(shù)

據(jù)共享交換體系，促進(jìn)全省數(shù)據(jù)高效共享和安全交換。

Ⅳ

DB32/T4608.2—2023

公共數(shù)據(jù)管理規(guī)范

第2部分：數(shù)據(jù)共享交換

1范圍

本文件規(guī)定了公共數(shù)據(jù)共享交換的職責(zé)分工、交換體系、數(shù)據(jù)接入、數(shù)據(jù)歸集、數(shù)據(jù)交換及數(shù)據(jù)安全

的要求。

本文件適用于依托省公共數(shù)據(jù)共享交換平臺(tái)開(kāi)展的公共數(shù)據(jù)共享交換工作。

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

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

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

文件。

GB/T22239信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求

GB/T39477信息安全技術(shù)政務(wù)信息共享數(shù)據(jù)安全技術(shù)要求

DB32/T4040.1政務(wù)大數(shù)據(jù)數(shù)據(jù)元標(biāo)準(zhǔn)第1部分：總則

DB32/T4040.2政務(wù)大數(shù)據(jù)數(shù)據(jù)元標(biāo)準(zhǔn)第2部分：公共數(shù)據(jù)元

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

公共管理和服務(wù)機(jī)構(gòu)publicadministrationandserviceinstitution

各級(jí)行政機(jī)關(guān)、法律法規(guī)授權(quán)的具有管理公共事務(wù)職能的組織、公共企事業(yè)單位。

3.2

公共數(shù)據(jù)publicdata

公共管理和服務(wù)機(jī)構(gòu)為履行法定職責(zé)、提供公共服務(wù)收集、產(chǎn)生的，以電子或者其他方式記錄、保存

的具有公共使用價(jià)值的信息記錄。

注：包括庫(kù)表、文件、服務(wù)接口和消息流等形式。

3.3

公共數(shù)據(jù)共享交換平臺(tái)publicdatasharingandexchangeplatform

依托省電子政務(wù)外網(wǎng)，開(kāi)展非涉密公共數(shù)據(jù)共享交換服務(wù)的平臺(tái)，滿足各級(jí)公共管理和服務(wù)機(jī)構(gòu)跨

地域、跨部門(mén)、跨層級(jí)的數(shù)據(jù)共享需求，供公共管理和服務(wù)機(jī)構(gòu)發(fā)布資源，檢索、申請(qǐng)、訂閱其他機(jī)構(gòu)資源。

注：以下簡(jiǎn)稱“共享交換平臺(tái)”。

3.4

機(jī)構(gòu)前置節(jié)點(diǎn)institutionfrontnode

部署在公共管理和服務(wù)機(jī)構(gòu)側(cè)，與省共享交換平臺(tái)對(duì)接，用于交換和共享數(shù)據(jù)的軟硬件設(shè)施。

1

DB32/T4608.2—2023

3.5

機(jī)構(gòu)前置庫(kù)institutionfrontdatabase

部署在公共管理和服務(wù)機(jī)構(gòu)側(cè)，連通機(jī)構(gòu)前置節(jié)點(diǎn)，與機(jī)構(gòu)業(yè)務(wù)庫(kù)橋接的獨(dú)立數(shù)據(jù)庫(kù)。

3.6

中心前置節(jié)點(diǎn)centrefrontnode

部署在省共享交換平臺(tái)側(cè)，用于接收和共享數(shù)據(jù)的軟硬件設(shè)施。

3.7

中心前置庫(kù)centrefrontdatabase

部署在省共享交換平臺(tái)側(cè)，連通中心前置節(jié)點(diǎn)，用于接收和共享數(shù)據(jù)的獨(dú)立數(shù)據(jù)庫(kù)。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

CDC：變更數(shù)據(jù)捕獲（ChangeDataCapture）

DDL：數(shù)據(jù)定義語(yǔ)言（DataDefinitionLanguage）

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

RESTful：表述性狀態(tài)傳遞（RepresentationalStateTransfer）

URL：統(tǒng)一資源定位符（UniformResourceLocator）

UTF-8：Unicode的一種可變長(zhǎng)度字符編碼（8位元，UniversalCharacterSet/UnicodeTransforma?

tionFormat）

5職責(zé)分工

5.1省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)

省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)的職責(zé)主要包括：

a）負(fù)責(zé)省共享交換平臺(tái)建設(shè)維護(hù)、運(yùn)行管理和安全保障；

b）按需提供機(jī)構(gòu)前置節(jié)點(diǎn)軟硬件資源環(huán)境，負(fù)責(zé)交換程序部署、賬號(hào)分配，提供技術(shù)支持及咨詢

服務(wù)；

c）歸并整合省級(jí)公共管理和服務(wù)機(jī)構(gòu)間的共享交換通道，與國(guó)家、設(shè)區(qū)市共享交換平臺(tái)對(duì)接，建立

健全全省一體化公共數(shù)據(jù)共享交換體系；

d）負(fù)責(zé)公共數(shù)據(jù)共享申請(qǐng)審批，促進(jìn)供需對(duì)接和數(shù)據(jù)回流，加強(qiáng)共享評(píng)價(jià)考核；

e）指導(dǎo)設(shè)區(qū)市開(kāi)展市級(jí)共享交換平臺(tái)建設(shè)和管理。

5.2市公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)

市公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)的職責(zé)主要包括：

a）負(fù)責(zé)建設(shè)和管理本行政區(qū)域共享交換平臺(tái)，并與省共享交換平臺(tái)對(duì)接；

b）歸并整合本行政區(qū)域內(nèi)公共管理和服務(wù)機(jī)構(gòu)間的共享交換通道；

c）歸集共享本行政區(qū)域內(nèi)的公共數(shù)據(jù)。

5.3公共管理和服務(wù)機(jī)構(gòu)

公共管理和服務(wù)機(jī)構(gòu)的職責(zé)主要包括：

a）明確本機(jī)構(gòu)的責(zé)任部門(mén)、負(fù)責(zé)人，做好本機(jī)構(gòu)公共數(shù)據(jù)的收集獲取、目錄編制、共享開(kāi)放、更新維

2

DB32/T4608.2—2023

護(hù)和安全保障等工作；

b）數(shù)據(jù)提供方負(fù)責(zé)對(duì)提供的公共數(shù)據(jù)分類分級(jí)、源頭治理和異議處理；

c）數(shù)據(jù)使用方負(fù)責(zé)對(duì)使用的公共數(shù)據(jù)實(shí)施安全保護(hù)，在授權(quán)范圍內(nèi)使用數(shù)據(jù)；

d）協(xié)助部署機(jī)構(gòu)前置節(jié)點(diǎn)交換程序，負(fù)責(zé)對(duì)軟硬件環(huán)境進(jìn)行巡檢維護(hù)。

6交換體系

6.1總體架構(gòu)

省共享交換平臺(tái)上聯(lián)國(guó)家平臺(tái)、下聯(lián)設(shè)區(qū)市平臺(tái)，各級(jí)平臺(tái)橫向?qū)颖拘姓^(qū)域公共管理和服務(wù)機(jī)

構(gòu)，形成橫向聯(lián)動(dòng)、縱向貫通的數(shù)據(jù)共享交換體系。

省共享交換平臺(tái)提供前置機(jī)、服務(wù)接口、消息流等交換方式，具備交換管理、運(yùn)行監(jiān)控、消息預(yù)警等能

力，實(shí)現(xiàn)跨地域、跨部門(mén)、跨層級(jí)的數(shù)據(jù)共享和安全管控，提升公共數(shù)據(jù)共享交換的協(xié)同和效率。

公共數(shù)據(jù)共享交換總體架構(gòu)見(jiàn)圖1。

6.2交換方式

6.2.1前置機(jī)交換

前置機(jī)交換主要是完成庫(kù)表、文件資源的交換，適合數(shù)據(jù)量較大且需要落地的公共數(shù)據(jù)共享，應(yīng)具備

下列功能：

a）橋接：建立機(jī)構(gòu)業(yè)務(wù)運(yùn)行區(qū)與機(jī)構(gòu)數(shù)據(jù)交換區(qū)之間的信息通道；

b）傳輸：實(shí)現(xiàn)機(jī)構(gòu)前置節(jié)點(diǎn)與中心前置節(jié)點(diǎn)之間的信息處理和穩(wěn)定可靠持續(xù)的信息交換；

c）管理：實(shí)現(xiàn)共享交換過(guò)程的流程配置、部署、執(zhí)行和管理。

6.2.2服務(wù)接口交換

服務(wù)接口交換是通過(guò)服務(wù)網(wǎng)關(guān)將數(shù)據(jù)提供方的服務(wù)接口代理、授權(quán)并提供給數(shù)據(jù)使用方調(diào)用的共享

交換方式，適用于業(yè)務(wù)協(xié)同、信息核驗(yàn)等實(shí)時(shí)性要求高的數(shù)據(jù)應(yīng)用場(chǎng)景。

6.2.3消息流交換

消息流交換是以消息隊(duì)列承載數(shù)據(jù)同步，實(shí)現(xiàn)消息流在數(shù)據(jù)提供方和數(shù)據(jù)使用方之間傳遞的共享交

換方式，適用于數(shù)據(jù)實(shí)時(shí)共享交換場(chǎng)景。

3

DB32/T4608.2—2023

公共數(shù)據(jù)共享交換總體架構(gòu)圖

1

圖

4

DB32/T4608.2—2023

7數(shù)據(jù)接入

7.1配置要求

7.1.1為確保共享交換性能，機(jī)構(gòu)前置節(jié)點(diǎn)的相關(guān)配置參數(shù)應(yīng)符合下列要求：

a）服務(wù)器配置最低要求滿足4核CPU、8G內(nèi)存和200G磁盤(pán)，可根據(jù)實(shí)際業(yè)務(wù)交換場(chǎng)景對(duì)服務(wù)器

進(jìn)行動(dòng)態(tài)擴(kuò)容；

b）選用國(guó)產(chǎn)主流操作系統(tǒng)和關(guān)系型數(shù)據(jù)庫(kù)，滿足交換服務(wù)的正常運(yùn)行需求。

7.1.2機(jī)構(gòu)前置節(jié)點(diǎn)應(yīng)基于電子政務(wù)外網(wǎng)，配置IP地址、開(kāi)通相應(yīng)端口、調(diào)整網(wǎng)絡(luò)策略，實(shí)現(xiàn)機(jī)構(gòu)前置節(jié)

點(diǎn)與省共享交換平臺(tái)的網(wǎng)絡(luò)互通。

7.2接入步驟

7.2.1接入申請(qǐng)

公共管理和服務(wù)機(jī)構(gòu)向省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)提交申請(qǐng)（申請(qǐng)表樣式見(jiàn)附錄A），明確接入機(jī)構(gòu)、

機(jī)構(gòu)前置節(jié)點(diǎn)、聯(lián)系人、聯(lián)系方式、平臺(tái)管理員等信息。申請(qǐng)經(jīng)審核通過(guò)后獲得接入權(quán)限。

7.2.2環(huán)境準(zhǔn)備

若由省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)提供機(jī)構(gòu)前置節(jié)點(diǎn)，經(jīng)申請(qǐng)審核通過(guò)后，省公共數(shù)據(jù)運(yùn)行管理機(jī)

構(gòu)發(fā)放云主機(jī)資源、安裝基礎(chǔ)軟件、配置IP地址和端口、開(kāi)通網(wǎng)絡(luò)策略，確保機(jī)構(gòu)前置節(jié)點(diǎn)與業(yè)務(wù)系統(tǒng)互

聯(lián)互通。

若公共管理和服務(wù)機(jī)構(gòu)自備機(jī)構(gòu)前置節(jié)點(diǎn)，應(yīng)根據(jù)省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)的要求配置IP地

址和端口、開(kāi)通網(wǎng)絡(luò)策略，確保機(jī)構(gòu)前置節(jié)點(diǎn)與中心前置節(jié)點(diǎn)互聯(lián)互通。

7.2.3賬號(hào)分配

省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)授權(quán)分配機(jī)構(gòu)管理員賬號(hào)。機(jī)構(gòu)管理員負(fù)責(zé)發(fā)放和管理本機(jī)構(gòu)內(nèi)部賬號(hào)。

7.2.4程序部署

省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)在機(jī)構(gòu)前置節(jié)點(diǎn)部署交換程序。

7.2.5接入聯(lián)調(diào)

公共管理和服務(wù)機(jī)構(gòu)在機(jī)構(gòu)前置庫(kù)中創(chuàng)建數(shù)據(jù)庫(kù)、表，省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)配合完成機(jī)構(gòu)前置

節(jié)點(diǎn)與省共享交換平臺(tái)的接入聯(lián)調(diào)工作。

8數(shù)據(jù)歸集

8.1歸集流程

8.1.1目錄編制

數(shù)據(jù)提供方編制本機(jī)構(gòu)的數(shù)據(jù)目錄，并在數(shù)據(jù)目錄系統(tǒng)中錄入、注冊(cè)及發(fā)布。省公共數(shù)據(jù)運(yùn)行

管理機(jī)構(gòu)對(duì)數(shù)據(jù)目錄進(jìn)行審核。

市共享交換平臺(tái)與省共享交換平臺(tái)實(shí)現(xiàn)數(shù)據(jù)目錄級(jí)聯(lián)，對(duì)數(shù)據(jù)目錄進(jìn)行編目、歸集和管理，實(shí)現(xiàn)

元數(shù)據(jù)管理、目錄管理、目錄服務(wù)。目錄級(jí)聯(lián)接入框架見(jiàn)圖2，應(yīng)符合以下要求：

5

DB32/T4608.2—2023

a）省共享交換平臺(tái)和市共享交換平臺(tái)分別建設(shè)數(shù)據(jù)目錄系統(tǒng)；

b）市共享交換平臺(tái)進(jìn)行市域機(jī)構(gòu)數(shù)據(jù)的編目、匯聚和管理；

c）市共享交換平臺(tái)從省共享交換平臺(tái)獲取服務(wù)接口授權(quán)，市共享交換平臺(tái)數(shù)據(jù)目錄系統(tǒng)在發(fā)布數(shù)

據(jù)目錄時(shí)，同時(shí)調(diào)用級(jí)聯(lián)上報(bào)接口，將數(shù)據(jù)目錄的元數(shù)據(jù)、數(shù)據(jù)字典等信息同步到省共享交換平

臺(tái)，完成數(shù)據(jù)目錄級(jí)聯(lián)。

圖2目錄級(jí)聯(lián)接入框架

8.1.2資源歸集

根據(jù)數(shù)據(jù)資源類型，采取相應(yīng)的交換方式，實(shí)現(xiàn)各類資源向省共享交換平臺(tái)的歸集：

a）庫(kù)表類：將庫(kù)表從機(jī)構(gòu)前置節(jié)點(diǎn)歸集到省共享交換平臺(tái)中心前置庫(kù)；

b）文件類：將文件從機(jī)構(gòu)前置節(jié)點(diǎn)歸集到省共享交換平臺(tái)中心前置節(jié)點(diǎn)；

c）服務(wù)接口類：將服務(wù)接口代理注冊(cè)到省共享交換平臺(tái)服務(wù)網(wǎng)關(guān)；

d）消息流類：將消息流歸集到省共享交換平臺(tái)消息隊(duì)列。

8.1.3資源掛接

數(shù)據(jù)提供方應(yīng)通過(guò)數(shù)據(jù)目錄系統(tǒng)將數(shù)據(jù)資源掛接到本機(jī)構(gòu)數(shù)據(jù)目錄下，建立數(shù)據(jù)目錄與數(shù)據(jù)資源的

關(guān)聯(lián)。

8.2歸集方式

8.2.1庫(kù)表歸集

歸集步驟

以庫(kù)表數(shù)據(jù)作為歸集對(duì)象，數(shù)據(jù)提供方推送數(shù)據(jù)到機(jī)構(gòu)前置庫(kù)，省共享交換平臺(tái)通過(guò)中心前置節(jié)點(diǎn)

6

DB32/T4608.2—2023

抽取數(shù)據(jù)，寫(xiě)入省共享交換平臺(tái)中心前置庫(kù)。步驟如下：

a）數(shù)據(jù)提供方對(duì)數(shù)據(jù)進(jìn)行源頭治理，按照DB32/T4040.1和DB32/T4040.2的要求和數(shù)據(jù)產(chǎn)生的

業(yè)務(wù)規(guī)則，從完整性、規(guī)范性、準(zhǔn)確性、一致性、及時(shí)性、可訪問(wèn)性對(duì)數(shù)據(jù)進(jìn)行質(zhì)量檢查；

b）數(shù)據(jù)提供方推送數(shù)據(jù)到機(jī)構(gòu)前置庫(kù)，首次推送全量數(shù)據(jù)，后續(xù)推送增量數(shù)據(jù)；

c）數(shù)據(jù)提供方發(fā)起數(shù)據(jù)推送請(qǐng)求；

d）省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)從機(jī)構(gòu)前置庫(kù)抽取數(shù)據(jù)到省共享交換平臺(tái)中心前置庫(kù)；

e）針對(duì)省共享交換平臺(tái)質(zhì)檢發(fā)現(xiàn)或由數(shù)據(jù)使用方反饋的異議數(shù)據(jù)，省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)向數(shù)

據(jù)提供方派發(fā)異議數(shù)據(jù)處理工單，數(shù)據(jù)提供方收到工單后進(jìn)行處理，并重新推送數(shù)據(jù)；

f）數(shù)據(jù)提供方按數(shù)據(jù)更新周期持續(xù)推送增量數(shù)據(jù)。

歸集類型

支持國(guó)產(chǎn)主流關(guān)系型數(shù)據(jù)庫(kù)的庫(kù)表歸集。

操作要求

.1機(jī)構(gòu)前置庫(kù)在初始化和增量交換過(guò)程中應(yīng)符合下列要求：

a）初始化時(shí)，添加數(shù)據(jù)庫(kù)時(shí)間戳字段，命名為：jhpt_update_time；

b）初始化時(shí)，添加數(shù)據(jù)增刪改標(biāo)記字段，命名為：jhpt_update_status；

注：字段值為I（代表insert，新增數(shù)據(jù)）、D（代表delete，刪除數(shù)據(jù)）或U（代表update，修改數(shù)據(jù)）。

c）初始化時(shí)，添加主鍵字段及索引；

d）庫(kù)表各字段填寫(xiě)中文注釋，注釋與資源目錄信息項(xiàng)保持一致；

e）庫(kù)表如存在外鍵，指定外鍵，獲取與其他庫(kù)表的關(guān)系，確保數(shù)據(jù)的完整性；

f）正確填寫(xiě)時(shí)間戳字段，服務(wù)器的操作系統(tǒng)時(shí)鐘準(zhǔn)確、穩(wěn)定；

g）庫(kù)表命名長(zhǎng)度控制在30位以內(nèi)，由大寫(xiě)英文字母、數(shù)字及下劃線組成；

h）當(dāng)數(shù)據(jù)結(jié)構(gòu)發(fā)生變更時(shí)，數(shù)據(jù)提供方數(shù)據(jù)結(jié)構(gòu)變更信息提供給省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)，并重

新推送數(shù)據(jù)；市公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)的數(shù)據(jù)結(jié)構(gòu)發(fā)生變更時(shí)，將原有的數(shù)據(jù)資源下線，并將變

更后的數(shù)據(jù)資源注冊(cè)發(fā)布。

.2庫(kù)表數(shù)據(jù)推送示例見(jiàn)附錄B。

數(shù)據(jù)字典

數(shù)據(jù)提供方應(yīng)將本機(jī)構(gòu)特有的數(shù)據(jù)字典提供給省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)備案，對(duì)于已發(fā)布統(tǒng)一數(shù)據(jù)

標(biāo)準(zhǔn)的元數(shù)據(jù)，應(yīng)按照數(shù)據(jù)字典要求提供數(shù)據(jù)，數(shù)據(jù)質(zhì)量應(yīng)符合要求。數(shù)據(jù)字典應(yīng)至少包含建表DDL

和代碼表：

a）DDL應(yīng)包含表名、表字段、表中文名、字段中文名、字段類型、字段長(zhǎng)度、是否主鍵、是否非空、外

鍵、索引、觸發(fā)器等信息；

b）代碼表應(yīng)包含所涉及的全部代碼項(xiàng)信息，包括代碼表名稱、代碼表字段等。

8.2.2文件歸集

歸集步驟

以文件作為歸集對(duì)象，數(shù)據(jù)提供方將文件寫(xiě)入機(jī)構(gòu)前置節(jié)點(diǎn)的指定目錄，省共享交換平臺(tái)按時(shí)抽取，

以文件方式存儲(chǔ)，同時(shí)將具有固定結(jié)構(gòu)的文件解析入庫(kù)。

7

DB32/T4608.2—2023

歸集類型

文件歸集支持csv、txt、xml、xls、xlsx、json、doc、docx、pdf、rar、zip、jpg、jpeg、gif、bmp、png等格式。

文件命名

數(shù)據(jù)提供方推送的文件數(shù)據(jù)，文件命名應(yīng)使用“數(shù)據(jù)表名/文件名稱”+“_”+“全/增量標(biāo)記（F：全

量/C：增量）”+“_”+“上報(bào)周期（D：日/W：周/M：月/Q：季度/H：半年/Y：年）”+“_”+“日期（8位連續(xù)

數(shù)字）”+“_”+“時(shí)間（6位連續(xù)數(shù)字，精確到秒）”的格式。數(shù)據(jù)提供方更新文件時(shí)，新推送的文件名除日

期和時(shí)間外，應(yīng)與原文件名一致。

示例：File_F_D_20230610_082600.txt。

8.2.3服務(wù)接口歸集

歸集步驟

以服務(wù)接口作為歸集對(duì)象，數(shù)據(jù)提供方需提供原始服務(wù)接口及其說(shuō)明文檔，省共享交換平臺(tái)通過(guò)服

務(wù)網(wǎng)關(guān)代理后統(tǒng)一對(duì)外提供服務(wù)。

歸集類型

省共享交換平臺(tái)可接入的服務(wù)接口類型為RESTful和WebService。

歸集格式

服務(wù)接口的數(shù)據(jù)格式應(yīng)符合下列要求：

a）服務(wù)接口消息數(shù)據(jù)優(yōu)先采用JSON格式，同時(shí)可支持XML格式；

b）服務(wù)請(qǐng)求和服務(wù)響應(yīng)的報(bào)文均采用UTF-8編碼，服務(wù)請(qǐng)求時(shí)HTTPS報(bào)文頭域中如需填寫(xiě)

content?type，其值應(yīng)為application/json；

c）服務(wù)請(qǐng)求由請(qǐng)求方法、資源標(biāo)識(shí)符和HTTPS協(xié)議版本三部分組成，格式按照https：//host/

base_path/v｛n｝/｛resources｝進(jìn)行設(shè)計(jì)；

d）服務(wù)響應(yīng)報(bào)文由狀態(tài)行、響應(yīng)頭部和響應(yīng)消息主體三部分組成。服務(wù)響應(yīng)報(bào)文狀態(tài)行包括報(bào)文

協(xié)議及版本、狀態(tài)碼及狀態(tài)描述兩部分。請(qǐng)求響應(yīng)狀態(tài)碼見(jiàn)附錄C的C.1，返回錯(cuò)誤碼見(jiàn)C.2。

接口功能

服務(wù)接口功能應(yīng)符合下列要求：

a）兼容性：迭代升級(jí)過(guò)程向后兼容；

b）可用性：后端接口性能、可靠性滿足實(shí)際需求，且平均響應(yīng)時(shí)間不超過(guò)1s，響應(yīng)成功率超過(guò)

99.99%；

c）防御性：設(shè)計(jì)時(shí)考慮流量控制、有效性檢查，避免外部異常導(dǎo)致接口不可用；

d）松耦性：接口與數(shù)據(jù)提供方的業(yè)務(wù)系統(tǒng)解耦，發(fā)生故障時(shí)不相互影響；

e）擴(kuò)展性：根據(jù)使用需求通過(guò)負(fù)載均衡實(shí)現(xiàn)服務(wù)接口橫向擴(kuò)展。

接口要求

服務(wù)接口應(yīng)符合下列技術(shù)要求：

a）接口協(xié)議：服務(wù)接口的通信協(xié)議使用HTTPS協(xié)議；

b）接口版本：將服務(wù)接口的版本號(hào)放入U(xiǎn)RL，支持多版本并存，版本號(hào)格式為v｛n｝，其中n代表版

8

DB32/T4608.2—2023

本號(hào)，為整型或浮點(diǎn)型；

c）接口方法：每個(gè)服務(wù)接口只含一個(gè)接口方法，數(shù)據(jù)提供方在注冊(cè)服務(wù)接口時(shí)標(biāo)明服務(wù)接口的返

回格式；

d）接口參數(shù)：服務(wù)接口的傳入?yún)?shù)在報(bào)文消息體中進(jìn)行傳遞，不應(yīng)在報(bào)文消息頭傳遞；

e）接口文檔：服務(wù)接口接入省共享交換平臺(tái)時(shí)，數(shù)據(jù)提供方提供服務(wù)接口使用說(shuō)明文檔。服務(wù)接

口文檔要求符合附錄D的規(guī)定。

8.2.4消息流歸集

歸集步驟

以消息數(shù)據(jù)作為歸集對(duì)象，省共享交換平臺(tái)通過(guò)CDC技術(shù)實(shí)時(shí)捕獲數(shù)據(jù)提供方業(yè)務(wù)庫(kù)（或前置庫(kù)）

日志變更，對(duì)外提供消息流服務(wù)。步驟如下：

a）數(shù)據(jù)提供方在業(yè)務(wù)庫(kù)（或前置庫(kù)）開(kāi)啟日志監(jiān)聽(tīng)功能；

b）數(shù)據(jù)提供方在省共享交換平臺(tái)配置數(shù)據(jù)源、數(shù)據(jù)表等信息；

c）數(shù)據(jù)提供方按的要求命名消息主題，創(chuàng)建并啟動(dòng)CDC消息同步任務(wù)；

d）省共享交換平臺(tái)根據(jù)CDC消息同步任務(wù)生成消息隊(duì)列數(shù)據(jù)，對(duì)外提供消息流服務(wù)。

歸集類型

支持國(guó)產(chǎn)主流關(guān)系型數(shù)據(jù)庫(kù)的消息歸集。

消息命名

創(chuàng)建消息主題，消息主題應(yīng)按照機(jī)構(gòu)業(yè)務(wù)庫(kù)（或前置庫(kù)）表名稱+“_topic”進(jìn)行命名，主要要求包括：

a）長(zhǎng)度控制在80位以內(nèi)；

b）由大寫(xiě)英文字母、數(shù)字及下劃線組成；

c）結(jié)構(gòu)為“Flow_BM_”+統(tǒng)一社會(huì)信用代碼+“_”+原始表名稱+“_topic”。

示例：Flow_BM_12320000466006279X_jsdata_topic。

9數(shù)據(jù)交換

公共數(shù)據(jù)共享交換流程見(jiàn)圖3，具體要求如下。

a）數(shù)據(jù)發(fā)布：數(shù)據(jù)提供方完成庫(kù)表數(shù)據(jù)推送、文件上傳、服務(wù)接口接入、消息流配置，并在省共享交

換平臺(tái)發(fā)布。

b）數(shù)據(jù)申請(qǐng)與審核：數(shù)據(jù)使用方對(duì)所需的公共數(shù)據(jù)提出申請(qǐng)，省公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)、數(shù)據(jù)提供

方對(duì)申請(qǐng)進(jìn)行審核反饋。

c）數(shù)據(jù)提供：省共享交換平臺(tái)和數(shù)據(jù)提供方做好數(shù)據(jù)提供準(zhǔn)備。其中，庫(kù)表數(shù)據(jù)提供時(shí)，數(shù)據(jù)提供

方和數(shù)據(jù)使用方應(yīng)先配置服務(wù)器地址、數(shù)據(jù)庫(kù)類型、數(shù)據(jù)庫(kù)版本等信息，省共享交換平臺(tái)對(duì)機(jī)構(gòu)

前置節(jié)點(diǎn)接入聯(lián)調(diào)。

d）數(shù)據(jù)獲?。簲?shù)據(jù)使用方獲取所需的公共數(shù)據(jù)。其中，文件可根據(jù)下載權(quán)限直接下載獲取；服務(wù)接

口獲取請(qǐng)求者身份標(biāo)識(shí)、服務(wù)編碼和授權(quán)碼等授權(quán)信息后，完成接口對(duì)接聯(lián)調(diào)。

e）數(shù)據(jù)交換對(duì)賬：數(shù)據(jù)提供方和數(shù)據(jù)使用方按周期、批次對(duì)公共數(shù)據(jù)交換過(guò)程中推送和接收的數(shù)

據(jù)進(jìn)行對(duì)賬。

f）數(shù)據(jù)異議反饋：數(shù)據(jù)使用方發(fā)現(xiàn)異議數(shù)據(jù)時(shí)，在省共享交換平臺(tái)中提交工單反饋，并由數(shù)據(jù)提供

方進(jìn)行異議處理。

9

DB32/T4608.2—2023

g）數(shù)據(jù)續(xù)約：省共享交換平臺(tái)對(duì)數(shù)據(jù)使用授權(quán)進(jìn)行臨期提醒，提供快速續(xù)約功能，方便數(shù)據(jù)使用方

進(jìn)行數(shù)據(jù)使用授權(quán)續(xù)約。

h）數(shù)據(jù)結(jié)構(gòu)變更：數(shù)據(jù)提供方變更申請(qǐng)通過(guò)后，庫(kù)表數(shù)據(jù)在省共享交換平臺(tái)上發(fā)布新版數(shù)據(jù)，通知

數(shù)據(jù)使用方限期內(nèi)停用舊版數(shù)據(jù)，同時(shí)申請(qǐng)新版數(shù)據(jù)；文件、服務(wù)接口通過(guò)省共享交換平臺(tái)

變更。

i）數(shù)據(jù)下線：數(shù)據(jù)提供方通過(guò)省共享交換平臺(tái)提交下線申請(qǐng)，審核通過(guò)后，尚未被申請(qǐng)使用，直接

下線；已被申請(qǐng)使用，通知數(shù)據(jù)使用方期限內(nèi)（30日）調(diào)整，到期后自動(dòng)下線。

圖3共享交換流程

10數(shù)據(jù)安全

10.1基本要求

各級(jí)共享交換平臺(tái)應(yīng)滿足GB/T22239中三級(jí)網(wǎng)絡(luò)安全等級(jí)保護(hù)要求和GB/T39477中共享數(shù)據(jù)

交換安全要求，在節(jié)點(diǎn)管理、授權(quán)管理、數(shù)據(jù)管控等方面發(fā)現(xiàn)不符合安全要求的，應(yīng)及時(shí)整改。

10.2節(jié)點(diǎn)管理

機(jī)構(gòu)前置節(jié)點(diǎn)應(yīng)按要求進(jìn)行安全防護(hù)，要求包括但不限于：

a）配置邊界防火墻，按照最小化原則設(shè)置網(wǎng)絡(luò)安全訪問(wèn)策略；

10

DB32/T4608.2—2023

b）配備病毒防護(hù)系統(tǒng)、漏洞掃描和補(bǔ)丁管理系統(tǒng)，提供主機(jī)安全服務(wù)；

c）采取安全認(rèn)證措施和安全管理策略，安全管理系統(tǒng)賬號(hào)；

d）對(duì)操作系統(tǒng)、數(shù)據(jù)庫(kù)、網(wǎng)絡(luò)設(shè)備等的防病毒、系統(tǒng)補(bǔ)丁進(jìn)行集中管理；

e）對(duì)交換節(jié)點(diǎn)服務(wù)器和操作終端進(jìn)行安全運(yùn)維管理，主要操作可審計(jì)、可回溯。

10.3授權(quán)管理

省共享交換平臺(tái)應(yīng)對(duì)數(shù)據(jù)提供方、數(shù)據(jù)使用方、公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)進(jìn)行權(quán)限控制，要求包括但不

限于：

a）對(duì)數(shù)據(jù)提供方和數(shù)據(jù)使用方進(jìn)行身份和權(quán)限驗(yàn)證，避免非法請(qǐng)求；

b）公共數(shù)據(jù)申請(qǐng)審批通過(guò)后才能進(jìn)行交換訂閱、授權(quán)；

c）申請(qǐng)的公共數(shù)據(jù)應(yīng)進(jìn)行有效期驗(yàn)證，過(guò)期的公共數(shù)據(jù)無(wú)法繼續(xù)使用；

d）數(shù)據(jù)提供方對(duì)服務(wù)接口進(jìn)行使用授權(quán)，數(shù)據(jù)使用方通過(guò)唯一授權(quán)碼進(jìn)行接口調(diào)用，未經(jīng)授權(quán)不

應(yīng)提供第三方使用；

e）加強(qiáng)省共享交換平臺(tái)接入口和接入終端的安全保密管理，采取入侵防范、惡意代碼檢測(cè)以及信

息涉密情況檢查等措施，提高防病毒、防攻擊、防信息泄露、數(shù)據(jù)防篡改及防竊取等能力；

f）可通過(guò)設(shè)置各機(jī)構(gòu)前置節(jié)點(diǎn)IP地址或賬戶的黑白名單控制其訪問(wèn)權(quán)限。

10.4數(shù)據(jù)管控

應(yīng)對(duì)公共數(shù)據(jù)共享交換過(guò)程進(jìn)行安全管控，要求包括但不限于：

a）數(shù)據(jù)提供方：

?定期檢查和評(píng)估本機(jī)構(gòu)業(yè)務(wù)運(yùn)行區(qū)至數(shù)據(jù)交換區(qū)數(shù)據(jù)傳輸?shù)陌踩院涂煽啃裕?/p>

?根據(jù)數(shù)據(jù)分類分級(jí)標(biāo)準(zhǔn)結(jié)合實(shí)際情況對(duì)所提供的公共數(shù)據(jù)進(jìn)行分類分級(jí)；

?根據(jù)數(shù)據(jù)的敏感程度，對(duì)相應(yīng)數(shù)據(jù)實(shí)施加密、脫敏等處理。

b）數(shù)據(jù)使用方：

?定期檢查和評(píng)估本機(jī)構(gòu)數(shù)據(jù)交換區(qū)至業(yè)務(wù)運(yùn)行區(qū)數(shù)據(jù)傳輸?shù)陌踩院涂煽啃裕?/p>

?根據(jù)數(shù)據(jù)分類分級(jí)標(biāo)準(zhǔn)對(duì)使用的公共數(shù)據(jù)實(shí)施安全保護(hù)，在授權(quán)范圍內(nèi)合規(guī)使用；

?對(duì)數(shù)據(jù)泄露、非授權(quán)使用等情形實(shí)時(shí)監(jiān)測(cè)告警，并及時(shí)處置、報(bào)告。

c）公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)：

?定期檢查和評(píng)估本級(jí)共享交換平臺(tái)數(shù)據(jù)傳輸?shù)陌踩院涂煽啃裕?/p>

?對(duì)本級(jí)數(shù)據(jù)共享交換通道運(yùn)行情況實(shí)時(shí)監(jiān)測(cè)告警，并及時(shí)處置；

?實(shí)時(shí)監(jiān)測(cè)服務(wù)接口調(diào)用，對(duì)調(diào)用頻次異常、調(diào)用超時(shí)、調(diào)用錯(cuò)誤、非授權(quán)調(diào)用等情況及時(shí)告

警處置；

?采用隱私計(jì)算、數(shù)據(jù)沙箱、數(shù)據(jù)水印等技術(shù)，加強(qiáng)數(shù)據(jù)使用安全管控；

?對(duì)數(shù)據(jù)提供方、數(shù)據(jù)使用方、公共數(shù)據(jù)運(yùn)行管理機(jī)構(gòu)的操作行為和數(shù)據(jù)交換等進(jìn)行審計(jì)。

11

DB32/T4608.2—2023

附錄A

（資料性）

接入申請(qǐng)表

接入申請(qǐng)表樣式見(jiàn)表A.1。

表A.1省公共數(shù)據(jù)共享交換平臺(tái)接入申請(qǐng)表

申請(qǐng)人信息

申請(qǐng)人聯(lián)系電話

機(jī)構(gòu)信息

申請(qǐng)機(jī)構(gòu)

統(tǒng)一社會(huì)信用代碼

管理員賬號(hào)信息

（賬號(hào)權(quán)限：可對(duì)該機(jī)構(gòu)進(jìn)行管理授權(quán)、資源申請(qǐng)審核、賬號(hào)新增，管理員賬號(hào)為本機(jī)構(gòu)最大權(quán)限賬號(hào)）

姓名手機(jī)號(hào)

工作人員賬號(hào)使用者信息

（賬號(hào)權(quán)限：可操作省平臺(tái)進(jìn)行申請(qǐng)，資源目錄注冊(cè)、統(tǒng)一工單使用等功能性權(quán)限）

姓名手機(jī)號(hào)

備注說(shuō)明

機(jī)構(gòu)首次申請(qǐng)可開(kāi)通一個(gè)管理員賬號(hào)和一個(gè)工作人員賬號(hào)，且一個(gè)機(jī)構(gòu)只能擁有一個(gè)管理員賬號(hào)，其他工作人員賬號(hào)

由管理員自行開(kāi)設(shè)

機(jī)構(gòu)蓋章

年月日

12

DB32/T4608.2—2023

附錄B

（資料性）

庫(kù)表數(shù)據(jù)推送示例

B.1新增數(shù)據(jù)

新增庫(kù)表數(shù)據(jù)的推送示例見(jiàn)表B.1。

表B.1新增庫(kù)表數(shù)據(jù)推送示例

rowguidxmsfzhfsjhpt_update_timejhpt_update_status

（唯一主鍵）（姓名）（身份證號(hào)）（分?jǐn)?shù)）（時(shí)間戳）（數(shù)據(jù)增刪改標(biāo)記）

6a4cfbd0?1d10王**32010119******0001602023?06?1217：12：13I

3523f426?e2ff李**32010319******0003602023?06?1217：12：13I

fb77e552?48a4劉**32010419******0004602023?06?1217：12：13I

5044467c?84dd陳**32010519******0005602023?06?1217：12：13I

B.2修改數(shù)據(jù)

修改庫(kù)表數(shù)據(jù)的推送示例見(jiàn)表B.2。

表B.2修改庫(kù)表數(shù)據(jù)推送示例

rowguidxmsfzhfsjhpt_update_timejhpt_update_status

（唯一主鍵）（姓名）（身份證號(hào)）（分?jǐn)?shù)）（時(shí)間戳）（數(shù)據(jù)增刪改標(biāo)記）

6a4cfbd0?1d10王**32010119******0001882023?06?1315：17：12U

3523f426?e2ff李**32010319******0003902023?06?1315：17：12U

fb77e552?48a4劉**32010419******0004912023?06?1315：17：12U

5044467c?84dd陳**32010519******0005782023?06?1315：17：12U

B.3刪除數(shù)據(jù)

刪除庫(kù)表數(shù)據(jù)的推送示例見(jiàn)表B.3。

表B.3刪除庫(kù)表數(shù)據(jù)推送示例

rowguidxmsfzhfsjhpt_update_timejhpt_update_status

（唯一主鍵）（姓名）（身份證號(hào)）（分?jǐn)?shù)）（時(shí)間戳）（數(shù)據(jù)增刪改標(biāo)記）

6a4cfbd0?1d10王**32010119******0001882023?06?1410：13：14D

3523f426?e2ff李**32010319******0003902023?06?1410：13：14D

fb77e552?48a4劉**32010419******0004912023?06?1410：13：14D

5044467c?84dd陳**32010519******0005782023?06?1410：13：14D

13

DB32/T4608.2—2023

附錄C

（資料性）

服務(wù)接口狀態(tài)碼代碼集

C.1服務(wù)接口請(qǐng)求響應(yīng)狀態(tài)碼

服務(wù)接口請(qǐng)求響應(yīng)狀態(tài)碼見(jiàn)表C.1。

表C.1服務(wù)接口請(qǐng)求響應(yīng)狀態(tài)碼

編碼說(shuō)明

100Continue

200OK

201Created

202Accepted

204NoContent

400BadRequest

401Unauthorized

403Forbidden

404NotFound

405MethodNotAllowed

406NotAcceptable

409Conflict

410Gone

412PreconditionFailed

429Toomanyrequests

500InternalServerError

501NotImplemented

503ServiceUnavailable

C.2服務(wù)接口返回錯(cuò)誤碼

服務(wù)接口返回錯(cuò)誤碼見(jiàn)表C.2。

表C.2服務(wù)接口返回錯(cuò)誤碼

編碼說(shuō)明

E?001請(qǐng)求體未攜帶數(shù)據(jù)包頭

E?002數(shù)據(jù)包頭中第一個(gè)子節(jié)點(diǎn)為空

14

DB32/T4608.2—2023

表C.2服務(wù)接口返回錯(cuò)誤碼（續(xù)）

編碼說(shuō)明

E?004請(qǐng)求數(shù)據(jù)格式有錯(cuò)誤

E?005權(quán)限認(rèn)證失敗

E?006請(qǐng)求失敗

E?007出錯(cuò)

E?008認(rèn)證數(shù)據(jù)同步異常

E?009請(qǐng)求超時(shí)

E?010調(diào)用失敗

E?100沒(méi)有進(jìn)行過(guò)數(shù)據(jù)同步的初始化過(guò)程，無(wú)法得到服務(wù)表信息

E?101服務(wù)不存在于數(shù)據(jù)庫(kù)服務(wù)列表中

E?102服務(wù)已過(guò)期

E?103沒(méi)有進(jìn)行過(guò)數(shù)據(jù)同步的初始化過(guò)程，無(wú)法得到服務(wù)表信息

E?104請(qǐng)求ID不存在于數(shù)據(jù)庫(kù)請(qǐng)求列表中

E?105沒(méi)有進(jìn)行過(guò)數(shù)據(jù)同步的初始化過(guò)程，無(wú)法得到服務(wù)表信息

E?106請(qǐng)求不存在于數(shù)據(jù)庫(kù)授權(quán)列表中

E?107沒(méi)有進(jìn)行過(guò)數(shù)據(jù)同步的初始化過(guò)程，無(wú)法得到服務(wù)表信息

E?108輸入的密鑰錯(cuò)誤

E?109密鑰驗(yàn)證失敗

E?102?1服務(wù)已停止（下線）

E?110密鑰已過(guò)期

R?001獲取頭信息

R?002進(jìn)入應(yīng)急通道

R?003未攜帶附件

R?004調(diào)用真正的服務(wù)地址

R?005調(diào)用成功

R?006調(diào)用結(jié)束

15

DB32/T4608.2—2023

附錄D

（規(guī)范性）

服務(wù)接口文檔要求

D.1接口歸集內(nèi)容

服務(wù)接口的基本信息應(yīng)至少包含下列內(nèi)容：

a）接口名稱：服務(wù)接口的中文名稱；

b）接口描述：對(duì)服務(wù)接口的功能、使用場(chǎng)景等進(jìn)行描述；

c）接口類型：服務(wù)接口類型，如RESTful、WebService；

d）請(qǐng)求方式：服務(wù)接口請(qǐng)求方式，如GET、POST；

e）調(diào)用頻次：對(duì)最大允許調(diào)用頻次和瞬時(shí)并發(fā)量進(jìn)行說(shuō)明，例如：5萬(wàn)次/d和2千次/s；

f）超時(shí)時(shí)間：服務(wù)接口調(diào)用超時(shí)時(shí)長(zhǎng)，根據(jù)實(shí)際情況填寫(xiě)；

g）共享類型：有條件共享、無(wú)條件共享或不予共享；

h）共享?xiàng)l件：數(shù)據(jù)共享的行政依據(jù)和法律法規(guī)；

i）授權(quán)類型：整體授權(quán)或非整體授權(quán)；

j）數(shù)據(jù)更新周期：服務(wù)接口后端數(shù)據(jù)源的更新周期，例如：每天、每周、每月；

k）URL：服務(wù)接口的IP地址、端口號(hào)以及服務(wù)的詳細(xì)路徑；

l）請(qǐng)求頭域：請(qǐng)求頭中需要傳入?yún)?shù)的含義描述；

m）頭域樣例：請(qǐng)求頭域的傳值格式樣例；

n）輸入?yún)?shù)：對(duì)請(qǐng)求報(bào)文中各個(gè)輸入?yún)?shù)的含義、字段類型、長(zhǎng)度等進(jìn)行詳細(xì)描述，并給出填寫(xiě)指

導(dǎo)，如需填寫(xiě)代碼，給出對(duì)應(yīng)代碼表；

o）輸入樣例：提供典型場(chǎng)景下服務(wù)接口的完整調(diào)用示例，調(diào)用示例中涉及到的敏感信息可脫敏后

呈現(xiàn)，并做出相關(guān)說(shuō)明；

p）響應(yīng)頭域：響應(yīng)數(shù)據(jù)的格式說(shuō)明；

q）輸出參數(shù)：對(duì)返回報(bào)文中各個(gè)輸出參數(shù)的含義、字段類型、長(zhǎng)度等進(jìn)行詳細(xì)描述，如包含返回代

碼，給出對(duì)應(yīng)代碼表；

r）輸出樣例：提供典型場(chǎng)景下服務(wù)接口請(qǐng)求成功和失敗時(shí)的返回?cái)?shù)據(jù)示例，返回示例中涉及的敏

感信息可脫敏后呈現(xiàn)，并做出相關(guān)說(shuō)明。

D.2服務(wù)接口使用說(shuō)明文檔示例

服務(wù)接口使用說(shuō)明文檔示例見(jiàn)表D.1。

表D.1服務(wù)接口使用說(shuō)明文檔示例

接口名稱人員信息查詢接口

接口描述可用于查詢對(duì)應(yīng)人員的手機(jī)號(hào)碼及戶籍地址信息的服務(wù)

接口類型RESTful

請(qǐng)求方式POST

調(diào)用頻次5萬(wàn)次/d超時(shí)時(shí)間30000ms

共享類型有條件共享共享?xiàng)l件有行政依據(jù)，符合國(guó)家法律法規(guī)

16

DB32/T4608.2—2023

表D.1服務(wù)接口使用說(shuō)明文檔示例（續(xù)）

授權(quán)類型整體授權(quán)數(shù)據(jù)更新周期實(shí)時(shí)

URLhttps：//IP：PORT/base_path/v1/resources

參數(shù)名類型長(zhǎng)度