ICS 35.080 L 76 DB34 安 徽 省 地 方 标 准 DB 34/T 3686—2020 电子政务外网数据交换级联接口规范 Interface Specification of E-Government Network Data Exchange Cascade 文稿版次选择 2020 - 08 - 03 发布 安徽省市场监督管理局 2020 - 09 - 03 实施 发 布 DB34/T 3686—2020 目 次 前言 ................................................................................ II  1 范围 .............................................................................. 1  2 术语和定义 ........................................................................ 1  3 级联架构 .......................................................................... 1  4 级联接口对接流程 .................................................................. 2  4.1 4.2 4.3 5 目录级联接口对接流程 .......................................................... 2  资源级联接口对接流程 .......................................................... 3  供需级联接口对接流程 .......................................................... 6  级联接口规范 ...................................................................... 7  5.1 5.2 5.3 5.4 5.5 5.6 接口技术要求 .................................................................. 7  接口协议 ...................................................................... 7  接口访问方式 .................................................................. 7  目录级联接口 .................................................................. 7  资源级联接口 ................................................................. 11  供需级联接口 ................................................................. 16  附录 A（规范性附录） 实体定义 ....................................................... 20  附录 B（规范性附录） 数据字典定义 ................................................... 22  附录 C（规范性附录） 返回信息定义 ................................................... 26  附录 D（资料性附录） 接口示例 ....................................................... 27  I DB34/T 3686—2020 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。 本标准由安徽省经济信息中心提出。 本标准由安徽省信息技术标准化技术委员会归口。 本标准起草单位：安徽省经济信息中心、讯飞智元信息科技有限公司。 本标准主要起草人：刘国忠、孙明、王晓波、张成、操亚松、宋琦、卓刘、王成勇。 II DB34/T 3686—2020 电子政务外网数据交换级联接口规范 1 范围 本标准规定了电子政务外网数据交换级联接口的术语和定义、级联架构、级联模式和级联接口规范。 本标准适用于市级共享平台与省级共享平台的数据目录、数据资源和供需数据的级联建设。 2 术语和定义 下列术语和定义适用于本文件。 2.1 省级共享平台 provincial sharing platform 电子政务外网全省政务信息资源共享与数据交换的平台。 2.2 市级共享平台 municipal sharing platform 电子政务外网政务信息资源共享与数据交换的市级平台。 2.3 级联接口 cascade interface 实现国家、省、市共享平台数据交换的接口。 3 级联架构 级联架构见图1。 1 DB34/T 3686—2020 图1 4 级联接口对接流程 4.1 目录级联接口对接流程 目录级联接口对接流程见图2。 2 级联架构 DB34/T 3686—2020 图2 4.2 目录级联接口对接流程 资源级联接口对接流程 4.2.1 交换方式 市级共享平台与省级共享平台资源级联包括资源上报与资源共享两个阶段，支持库表交换方式、文 件交换方式、服务接口交换方式。 4.2.2 库表、文件级联对接流程 库表、文件级联对接流程见图3。 3 DB34/T 3686—2020 图3 4 库表、文件级联接口对接流程 DB34/T 3686—2020 4.2.3 服务接口级联对接流程 服务接口级联对接流程见图4。 图4 服务接口级联对接流程 5 DB34/T 3686—2020 4.3 供需级联接口对接流程 资源需求方可在本市共享平台查看省级共享平台已发布的目录、申请资源订阅。资源提供方查看订 阅申请，审核是否提供给资源需求方。供需级联接口对接流程见图5。 图5 6 供需级联接口对接流程 DB34/T 3686—2020 5 级联接口规范 5.1 接口技术要求 市级共享平台与省级共享平台采用 API 接口的方式实现对接和数据同步。 5.2 接口协议 接口协议包括： ——协议：HTTP+JSON； ——方法：POST； ——内容类型：application/xwwy-form-urlencode。 5.3 接口访问方式 市级共享平台通过省级共享平台分配的 AppID、AppSecret，数据签名公钥进行业务接口访问。 5.4 目录级联接口 5.4.1 目录分类获取接口 5.4.1.1 接口实现市级共享平台目录系统从省级共享平台目录系统获取本市目录分类。目录分类编码 见附录 B 中 B.1 的定义。 5.4.1.2 消息包括请求消息和返回消息，字段如下： ——请求消息字段见表 1； ——返回消息字段见表 2。 表1 目录分类获取接口请求消息字段 字段名 约束 类型 说明 data 必填 object 分类实体，见附录A 中 A.1 的定义 表2 目录分类获取接口返回消息字段 字段名 类型 说明 resultCode string 返回码，见附录 C 中 C.1 的定义 resultInfo string 结果信息 resultErrInfo string 错误信息 resultData object 分类实体，见附录A 中 A.1 的定义 5.4.2 5.4.2.1 5.4.2.2 目录分类创建接口 接口实现市级共享平台目录系统在省级共享平台目录系统创建本市目录分类。 消息包括请求消息和返回消息，字段如下： ——请求消息字段见表 3； ——返回消息字段见表 4。 7 DB34/T 3686—2020 表3 目录分类创建接口请求消息字段 字段名 约束 类型 说明 data 必填 object 分类实体，见附录A 中 A.1 的定义 表4 5.4.3 目录分类创建接口返回消息字段 字段名 类型 说明 resultCode string 返回码，见附录C 中 C.1 的定义 resultInfo string 结果信息 resultErrInfo string 错误信息 resultData string 新增目录分类返回分类代码 目录分类编辑接口 5.4.3.1 接口实现市级共享平台目录系统在省级共享平台目录系统编辑本市目录分类信息。 5.4.3.2 消息包括请求消息和返回消息，字段如下： ——请求消息字段见表 5； ——返回消息字段见表 6。 表5 目录分类编辑接口请求消息字段 字段名 约束 类型 说明 data 必填 object 分类实体，见附录A 中 A.1 的定义 表6 5.4.4 目录分类编辑接口返回消息字段 字段名 类型 说明 resultCode string 返回码，见附录C 中 C.1 的定义 resultInfo string 结果信息 resultErrInfo string 错误信息 目录分类删除接口 5.4.4.1 接口实现市级共享平台目录系统在省级共享平台目录系统删除本市目录分类。 5.4.4.2 消息包括请求消息和返回消息，字段如下： ——请求消息字段见表 7； ——返回消息字段见表 8。 表7 字段名 约束 类型 说明 code 必填 object 目录分类编码，见附录B 中 B.1 的定义 表8 8 目录分类删除接口请求消息字段 目录分类删除接口返回消息字段 字段名 类型 说明 resultCode string 返回码，见附录C 中 C.1 的定义 resultInfo string 结果信息 DB34/T 3686—2020 resultErrInfo 5.4.5 string 错误信息 目录获取接口 5.4.5.1 接口实现市级共享平台目录系统获取省级共享平台