DB34/T 3686-2020 电子政务外网数据交换级联接口规范

ICS35.080

L76

DB34

安徽省地方标准

DB34/T3686—2020

电子政务外网数据交换级联接口规范

InterfaceSpecificationofE-GovernmentNetworkDataExchangeCascade

文稿版次选择

2020-08-03发布2020-09-03实施

安徽省市场监督管理局发布

DB34/T3686—2020

目次

前言II

1范围1

2术语和定义1

3级联架构1

4级联接口对接流程2

4.1目录级联接口对接流程2

4.2资源级联接口对接流程3

4.3供需级联接口对接流程6

5级联接口规范7

5.1接口技术要求7

5.2接口协议7

5.3接口访问方式7

5.4目录级联接口7

5.5资源级联接口11

5.6供需级联接口16

附录A（规范性附录）实体定义20

附录B（规范性附录）数据字典定义22

附录C（规范性附录）返回信息定义26

附录D（资料性附录）接口示例27

I

DB34/T3686—2020

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由安徽省经济信息中心提出。

本标准由安徽省信息技术标准化技术委员会归口。

本标准起草单位：安徽省经济信息中心、讯飞智元信息科技有限公司。

本标准主要起草人：刘国忠、孙明、王晓波、张成、操亚松、宋琦、卓刘、王成勇。

II

DB34/T3686—2020

电子政务外网数据交换级联接口规范

1范围

本标准规定了电子政务外网数据交换级联接口的术语和定义、级联架构、级联模式和级联接口规范。

本标准适用于市级共享平台与省级共享平台的数据目录、数据资源和供需数据的级联建设。

2术语和定义

下列术语和定义适用于本文件。

2.1

省级共享平台provincialsharingplatform

电子政务外网全省政务信息资源共享与数据交换的平台。

2.2

市级共享平台municipalsharingplatform

电子政务外网政务信息资源共享与数据交换的市级平台。

2.3

级联接口cascadeinterface

实现国家、省、市共享平台数据交换的接口。

3级联架构

级联架构见图1。

1

DB34/T3686—2020

图1级联架构

4级联接口对接流程

4.1目录级联接口对接流程

目录级联接口对接流程见图2。

2

DB34/T3686—2020

图2目录级联接口对接流程

4.2资源级联接口对接流程

4.2.1交换方式

市级共享平台与省级共享平台资源级联包括资源上报与资源共享两个阶段，支持库表交换方式、文

件交换方式、服务接口交换方式。

4.2.2库表、文件级联对接流程

库表、文件级联对接流程见图3。

3

DB34/T3686—2020

图3库表、文件级联接口对接流程

4

DB34/T3686—2020

4.2.3服务接口级联对接流程

服务接口级联对接流程见图4。

图4服务接口级联对接流程

5

DB34/T3686—2020

4.3供需级联接口对接流程

资源需求方可在本市共享平台查看省级共享平台已发布的目录、申请资源订阅。资源提供方查看订

阅申请，审核是否提供给资源需求方。供需级联接口对接流程见图5。

图5供需级联接口对接流程

6

DB34/T3686—2020

5级联接口规范

5.1接口技术要求

市级共享平台与省级共享平台采用API接口的方式实现对接和数据同步。

5.2接口协议

接口协议包括：

——协议：HTTP+JSON；

——方法：POST；

——内容类型：application/xwwy-form-urlencode。

5.3接口访问方式

市级共享平台通过省级共享平台分配的AppID、AppSecret，数据签名公钥进行业务接口访问。

5.4目录级联接口

5.4.1目录分类获取接口

接口实现市级共享平台目录系统从省级共享平台目录系统获取本市目录分类。目录分类编码

见附录B中B.1的定义。

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

——请求消息字段见表1；

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

表1目录分类获取接口请求消息字段

字段名约束类型说明

data必填object分类实体，见附录A中A.1的定义

表2目录分类获取接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

resultDataobject分类实体，见附录A中A.1的定义

5.4.2目录分类创建接口

接口实现市级共享平台目录系统在省级共享平台目录系统创建本市目录分类。

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

——请求消息字段见表3；

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

7

DB34/T3686—2020

表3目录分类创建接口请求消息字段

字段名约束类型说明

data必填object分类实体，见附录A中A.1的定义

表4目录分类创建接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

resultDatastring新增目录分类返回分类代码

5.4.3目录分类编辑接口

接口实现市级共享平台目录系统在省级共享平台目录系统编辑本市目录分类信息。

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

——请求消息字段见表5；

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

表5目录分类编辑接口请求消息字段

字段名约束类型说明

data必填object分类实体，见附录A中A.1的定义

表6目录分类编辑接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

5.4.4目录分类删除接口

接口实现市级共享平台目录系统在省级共享平台目录系统删除本市目录分类。

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

——请求消息字段见表7；

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

表7目录分类删除接口请求消息字段

字段名约束类型说明

code必填object目录分类编码，见附录B中B.1的定义

表8目录分类删除接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

8

DB34/T3686—2020

resultErrInfostring错误信息

5.4.5目录获取接口

接口实现市级共享平台目录系统获取省级共享平台目录系统已发布的目录。

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

——请求消息字段见表9；

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

表9目录获取接口请求消息字段

字段名约束类型说明

pageSize选填int每页显示大小

currentPage选填int当前页

startTime选填timestamp目录更新起始时间

endTime选填timestamp目录更新结束时间

id选填string目录id

name选填string目录名称

catalogCode选填string目录所属分类

表10目录获取接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

resultDataString返回数据

5.4.6目录创建接口

接口实现市级共享平台目录系统在省级共享平台目录系统创建本市目录。

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

——请求消息字段见表11；

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

表11目录创建接口请求消息字段

字段名约束类型说明

data必填object目录实体，见附录A中A.2定义

表12目录创建接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

resultDataString新增目录返回id

9

DB34/T3686—2020

5.4.7目录编辑接口

接口实现市级共享平台目录系统在省级共享平台目录系统编辑本市目录信息。

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

——请求消息字段见表13；

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

表13目录编辑接口请求消息字段

字段名约束类型说明

data必填object目录实体，见附录A中A.2定义

表14目录编辑接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

注：接口示例参见附录D中的D.1。

5.4.8目录删除接口

接口实现市级共享平台目录系统在省级共享平台目录系统删除本市目录。

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

——请求消息字段见表15；

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

表15目录删除接口请求消息字段

字段名约束类型说明

code必填string信息资源代码

表16目录删除接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

5.4.9目录状态变更接口

接口实现市级共享平台目录系统在省级共享平台目录系统更新本市目录状态。

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

——请求消息字段见表17；

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

10

DB34/T3686—2020

表17目录状态变更接口请求消息字段

字段名约束类型说明

code必填object信息资源代码

status必填object目录状态，见附录B中B.2的规定

表18目录状态变更接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

5.5资源级联接口

5.5.1库表接口

库表资源上报

.1接口实现市级共享平台级联系统提供库表资源到省级共享平台。

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

——请求消息字段见表19；

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

表19库表资源上报接口请求消息字段

字段名约束类型说明

userInfo必填object用户信息

data必填object库表资源上报信息

表20库表上报接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

resultDatastring上报返回资源id

注：库表资源上报接口示例参见附录D中的D.2。

库表资源下线

.1接口实现市级共享平台级联系统下线已上报至省级共享平台的库表资源。

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

——请求消息字段见表21；

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

11

DB34/T3686—2020

表21库表资源下线接口请求消息字段

字段名约束类型说明

userInfo必填object用户信息

data必填object库表资源下线信息

表22库表资源下线接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

resultDatastring空

获取库表资源列表

.1接口实现市级共享平台级联系统获取省级共享平台库表资源的列表信息。

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

——请求消息字段见表23；

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

表23获取库表资源列表接口请求消息字段

字段名约束类型说明

userInfo必填object用户信息

data必填object分页查询国家和省库表资源

表24获取库表资源列表接口返回消息字段

字段名类型说明

resultCodestring返回码，见附录C中C.1的定义

resultInfostring结果信息

resultErrInfostring错误信息

resultDatastring分页列表

获取库表资源详情

.1接口实现市级共享平台级联系统获取省级共享平台的库表资源详细信息。

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

——请求消息字段见表25；

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

表25获取库表资源详情接口请求消息字段

字段名约束类型说明

userInfo必填object用户信息

data必填object库表资源查询信息

12

DB34/T3686—2020

表26获取库表资源列表接口返回消息字段

字段名