ICS35.080

L76

DB34

安徽省地方標(biāo)準(zhǔn)

DB34/T3686—2020

電子政務(wù)外網(wǎng)數(shù)據(jù)交換級聯(lián)接口規(guī)范

InterfaceSpecificationofE-GovernmentNetworkDataExchangeCascade

文稿版次選擇

2020-08-03發(fā)布2020-09-03實施

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

DB34/T3686—2020

目次

前言II

1范圍1

2術(shù)語和定義1

3級聯(lián)架構(gòu)1

4級聯(lián)接口對接流程2

4.1目錄級聯(lián)接口對接流程2

4.2資源級聯(lián)接口對接流程3

4.3供需級聯(lián)接口對接流程6

5級聯(lián)接口規(guī)范7

5.1接口技術(shù)要求7

5.2接口協(xié)議7

5.3接口訪問方式7

5.4目錄級聯(lián)接口7

5.5資源級聯(lián)接口11

5.6供需級聯(lián)接口16

附錄A（規(guī)范性附錄）實體定義20

附錄B（規(guī)范性附錄）數(shù)據(jù)字典定義22

附錄C（規(guī)范性附錄）返回信息定義26

附錄D（資料性附錄）接口示例27

I

DB34/T3686—2020

前言

本標(biāo)準(zhǔn)按照GB/T1.1-2009給出的規(guī)則起草。

本標(biāo)準(zhǔn)由安徽省經(jīng)濟信息中心提出。

本標(biāo)準(zhǔn)由安徽省信息技術(shù)標(biāo)準(zhǔn)化技術(shù)委員會歸口。

本標(biāo)準(zhǔn)起草單位：安徽省經(jīng)濟信息中心、訊飛智元信息科技有限公司。

本標(biāo)準(zhǔn)主要起草人：劉國忠、孫明、王曉波、張成、操亞松、宋琦、卓劉、王成勇。

II

DB34/T3686—2020

電子政務(wù)外網(wǎng)數(shù)據(jù)交換級聯(lián)接口規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了電子政務(wù)外網(wǎng)數(shù)據(jù)交換級聯(lián)接口的術(shù)語和定義、級聯(lián)架構(gòu)、級聯(lián)模式和級聯(lián)接口規(guī)范。

本標(biāo)準(zhǔn)適用于市級共享平臺與省級共享平臺的數(shù)據(jù)目錄、數(shù)據(jù)資源和供需數(shù)據(jù)的級聯(lián)建設(shè)。

2術(shù)語和定義

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

2.1

省級共享平臺provincialsharingplatform

電子政務(wù)外網(wǎng)全省政務(wù)信息資源共享與數(shù)據(jù)交換的平臺。

2.2

市級共享平臺municipalsharingplatform

電子政務(wù)外網(wǎng)政務(wù)信息資源共享與數(shù)據(jù)交換的市級平臺。

2.3

級聯(lián)接口cascadeinterface

實現(xiàn)國家、省、市共享平臺數(shù)據(jù)交換的接口。

3級聯(lián)架構(gòu)

級聯(lián)架構(gòu)見圖1。

1

DB34/T3686—2020

圖1級聯(lián)架構(gòu)

4級聯(lián)接口對接流程

4.1目錄級聯(lián)接口對接流程

目錄級聯(lián)接口對接流程見圖2。

2

DB34/T3686—2020

圖2目錄級聯(lián)接口對接流程

4.2資源級聯(lián)接口對接流程

4.2.1交換方式

市級共享平臺與省級共享平臺資源級聯(lián)包括資源上報與資源共享兩個階段，支持庫表交換方式、文

件交換方式、服務(wù)接口交換方式。

4.2.2庫表、文件級聯(lián)對接流程

庫表、文件級聯(lián)對接流程見圖3。

3

DB34/T3686—2020

圖3庫表、文件級聯(lián)接口對接流程

4

DB34/T3686—2020

4.2.3服務(wù)接口級聯(lián)對接流程

服務(wù)接口級聯(lián)對接流程見圖4。

圖4服務(wù)接口級聯(lián)對接流程

5

DB34/T3686—2020

4.3供需級聯(lián)接口對接流程

資源需求方可在本市共享平臺查看省級共享平臺已發(fā)布的目錄、申請資源訂閱。資源提供方查看訂

閱申請，審核是否提供給資源需求方。供需級聯(lián)接口對接流程見圖5。

圖5供需級聯(lián)接口對接流程

6

DB34/T3686—2020

5級聯(lián)接口規(guī)范

5.1接口技術(shù)要求

市級共享平臺與省級共享平臺采用API接口的方式實現(xiàn)對接和數(shù)據(jù)同步。

5.2接口協(xié)議

接口協(xié)議包括：

——協(xié)議：HTTP+JSON；

——方法：POST；

——內(nèi)容類型：application/xwwy-form-urlencode。

5.3接口訪問方式

市級共享平臺通過省級共享平臺分配的AppID、AppSecret，數(shù)據(jù)簽名公鑰進行業(yè)務(wù)接口訪問。

5.4目錄級聯(lián)接口

5.4.1目錄分類獲取接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)從省級共享平臺目錄系統(tǒng)獲取本市目錄分類。目錄分類編碼

見附錄B中B.1的定義。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表1；

——返回消息字段見表2。

表1目錄分類獲取接口請求消息字段

字段名約束類型說明

data必填object分類實體，見附錄A中A.1的定義

表2目錄分類獲取接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDataobject分類實體，見附錄A中A.1的定義

5.4.2目錄分類創(chuàng)建接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)在省級共享平臺目錄系統(tǒng)創(chuàng)建本市目錄分類。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表3；

——返回消息字段見表4。

7

DB34/T3686—2020

表3目錄分類創(chuàng)建接口請求消息字段

字段名約束類型說明

data必填object分類實體，見附錄A中A.1的定義

表4目錄分類創(chuàng)建接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring新增目錄分類返回分類代碼

5.4.3目錄分類編輯接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)在省級共享平臺目錄系統(tǒng)編輯本市目錄分類信息。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表5；

——返回消息字段見表6。

表5目錄分類編輯接口請求消息字段

字段名約束類型說明

data必填object分類實體，見附錄A中A.1的定義

表6目錄分類編輯接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

5.4.4目錄分類刪除接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)在省級共享平臺目錄系統(tǒng)刪除本市目錄分類。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表7；

——返回消息字段見表8。

表7目錄分類刪除接口請求消息字段

字段名約束類型說明

code必填object目錄分類編碼，見附錄B中B.1的定義

表8目錄分類刪除接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

8

DB34/T3686—2020

resultErrInfostring錯誤信息

5.4.5目錄獲取接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)獲取省級共享平臺目錄系統(tǒng)已發(fā)布的目錄。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表9；

——返回消息字段見表10。

表9目錄獲取接口請求消息字段

字段名約束類型說明

pageSize選填int每頁顯示大小

currentPage選填int當(dāng)前頁

startTime選填timestamp目錄更新起始時間

endTime選填timestamp目錄更新結(jié)束時間

id選填string目錄id

name選填string目錄名稱

catalogCode選填string目錄所屬分類

表10目錄獲取接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDataString返回數(shù)據(jù)

5.4.6目錄創(chuàng)建接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)在省級共享平臺目錄系統(tǒng)創(chuàng)建本市目錄。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表11；

——返回消息字段見表12。

表11目錄創(chuàng)建接口請求消息字段

字段名約束類型說明

data必填object目錄實體，見附錄A中A.2定義

表12目錄創(chuàng)建接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDataString新增目錄返回id

9

DB34/T3686—2020

5.4.7目錄編輯接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)在省級共享平臺目錄系統(tǒng)編輯本市目錄信息。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表13；

——返回消息字段見表14。

表13目錄編輯接口請求消息字段

字段名約束類型說明

data必填object目錄實體，見附錄A中A.2定義

表14目錄編輯接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

注：接口示例參見附錄D中的D.1。

5.4.8目錄刪除接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)在省級共享平臺目錄系統(tǒng)刪除本市目錄。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表15；

——返回消息字段見表16。

表15目錄刪除接口請求消息字段

字段名約束類型說明

code必填string信息資源代碼

表16目錄刪除接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

5.4.9目錄狀態(tài)變更接口

接口實現(xiàn)市級共享平臺目錄系統(tǒng)在省級共享平臺目錄系統(tǒng)更新本市目錄狀態(tài)。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表17；

——返回消息字段見表18。

10

DB34/T3686—2020

表17目錄狀態(tài)變更接口請求消息字段

字段名約束類型說明

code必填object信息資源代碼

status必填object目錄狀態(tài)，見附錄B中B.2的規(guī)定

表18目錄狀態(tài)變更接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

5.5資源級聯(lián)接口

5.5.1庫表接口

庫表資源上報

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)提供庫表資源到省級共享平臺。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表19；

——返回消息字段見表20。

表19庫表資源上報接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object庫表資源上報信息

表20庫表上報接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring上報返回資源id

注：庫表資源上報接口示例參見附錄D中的D.2。

庫表資源下線

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)下線已上報至省級共享平臺的庫表資源。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表21；

——返回消息字段見表22。

11

DB34/T3686—2020

表21庫表資源下線接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object庫表資源下線信息

表22庫表資源下線接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring空

獲取庫表資源列表

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)獲取省級共享平臺庫表資源的列表信息。

.2消息包括請求消息和返回消息字段，如下：

——請求消息字段見表23；

——返回消息字段見表24。

表23獲取庫表資源列表接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object分頁查詢國家和省庫表資源

表24獲取庫表資源列表接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring分頁列表

獲取庫表資源詳情

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)獲取省級共享平臺的庫表資源詳細(xì)信息。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表25；

——返回消息字段見表26。

表25獲取庫表資源詳情接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object庫表資源查詢信息

12

DB34/T3686—2020

表26獲取庫表資源列表接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastringList<MetaDbObjectDto>列表

庫表資源表創(chuàng)建

.1接口實現(xiàn)市級共享平臺及聯(lián)系統(tǒng)在省級共享平臺地市前置機數(shù)據(jù)庫上創(chuàng)建表。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表27；

——返回消息字段見表28。

表27獲取庫表資源表創(chuàng)建接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object庫表資源信息

表28獲取庫表資源表創(chuàng)建接口請求消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring空

5.5.2文件夾接口

文件夾資源上報

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)提供文件夾資源到省級共享平臺。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表29；

——返回消息字段見表30。

表29獲取文件夾資源上報接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object文件夾交換信息

表30獲取文件夾資源上報接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

13

DB34/T3686—2020

resultErrInfostring錯誤信息

resultDatastring文件夾上報后在省端的id

文件夾資源下線

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)下線已上報至省級共享平臺的文件夾資源。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表31；

——返回消息字段見表32。

表31文件夾資源下線接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object文件夾交換信息

表32文件夾資源下線接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring文件夾上報后在省端的id

注：文件夾下線接口示例參見附錄D中D.3。

獲取文件夾資源信息

.1接口實現(xiàn)市級共享平臺及聯(lián)系統(tǒng)獲取省級共享平臺的文件夾資源信息。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表33；

——返回消息字段見表34。

表33獲取文件資源信息接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object分頁查詢文件夾資源信息

表34文件夾資源下線接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring分頁文件夾資源列表

5.5.3服務(wù)接口

接口資源上報

14

DB34/T3686—2020

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)提供接口資源到省級共享平臺。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表35；

——返回消息字段見表36。

表35接口資源上報接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object服務(wù)基本信息

表36接口資源上班接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring上報返回資源id

接口資源下線

.1接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)下線已上報至升級共享平臺的接口資源。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表37；

——返回消息字段見表38。

表37接口資源下線接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object服務(wù)基本信息

表38接口資源下線接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring空

5.5.4獲取接口資源列表

接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)獲取省級共享平臺的接口資源的列表信息。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表39；

——返回消息字段見表40。

15

DB34/T3686—2020

表39獲取接口資源列表接口請求消息字段

字段名約束類型說明

pageSize選填int每頁顯示大小

currentPage選填int當(dāng)前頁

startTime選填string更新起始時間

endTime選填string更新結(jié)束時間

id選填string目錄id

name選填string服務(wù)名稱

表40獲取接口資源列表接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring返回結(jié)果

5.5.5獲取接口資源詳情

接口實現(xiàn)市級共享平臺級聯(lián)系統(tǒng)獲取省級共享平臺的接口資源的詳細(xì)信息。

消息包括請求消息和返回消息，字段如下：

——請求消息字段見表41；

——返回消息字段見表42。

表41獲取接口資源詳情接口請求消息字段

字段名約束類型說明

serviceId必填string編號

表42獲取接口資源詳情接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultDatastring返回結(jié)果

resultErrInfostring錯誤信息

5.6供需級聯(lián)接口

5.6.1資源需求申請

資源申請

.1接口實現(xiàn)在市級共享平臺發(fā)起省內(nèi)資源申請，市級共享平臺將申請信息同步到省級共享平

臺。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表43；

16

DB34/T3686—2020

——返回消息字段見表44。

表43資源申請接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

data必填object資源基本信息

表44資源申請接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring返回結(jié)果

注：資源申請接口示例參見附錄D中D.4。

獲取資源申請結(jié)果

.1接口實現(xiàn)在市級共享平臺發(fā)起本省資源申請后，獲取資源申請的審核狀態(tài)及結(jié)果信息。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表45；

——返回消息字段見表46。

表45獲取資源申請結(jié)果接口請求消息字段

字段名約束類型說明

userInsfo必填object用戶信息

data必填object查詢資源信息

表46獲取資源申請結(jié)果接口放回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring錯誤信息

resultDatastring返回結(jié)果

獲取服務(wù)授權(quán)信息

.1接口實現(xiàn)在市級共享平臺發(fā)起本省接口資源申請已通過，獲取接口資源授權(quán)信息。

.2消息包括請求消息和返回消息，字段如下：

——請求消息字段見表47；

——返回消息字段見表48。

表47獲取服務(wù)授權(quán)信息接口請求消息字段

字段名約束類型說明

userInfo必填object用戶信息

17

DB34/T3686—2020

data必填object查詢服務(wù)授權(quán)信息

表48獲取服務(wù)授權(quán)信息接口返回消息字段

字段名類型說明

resultCodestring返回碼，見附錄C中C.1的定義

resultInfostring結(jié)果信息

resultErrInfostring