DB35/T 1884-2019 政务数据汇聚 核心接口描述

ICS01.040.35

L72

DB35

福建省地方标准

DB35/T1884—2019

政务数据汇聚核心接口描述

Governmentaldataingestion—Coreinterfacedescriptionspecification

2019-12-19发布2020-03-19实施

福建省市场监督管理局发布

DB35/T1884—2019

目次

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

引言...............................................................................III

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4缩略语............................................................................2

5核心接口操作描述..................................................................2

6接口扩展描述......................................................................3

7错误代码..........................................................................4

8接口返回格式......................................................................4

附录A（规范性附录）核心接口描述信息................................................5

附录B（资料性附录）核心接口描述示例................................................8

参考文献.............................................................................9

I

DB35/T1884—2019

前言

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

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

本标准由数字中国研究院（福建）提出。

本标准由福建省信息化标准化技术委员会（SAFJ/TC11）归口。

本标准起草单位：数字中国研究院（福建）、福建工程学院、福建省标准化研究院、福州大学、

福建省星云大数据应用服务有限公司、福建省政府办公厅电子政务中心、福大经纬信息科技有限公司。

本标准主要起草人：余劲松弟、佟瑞菊、文芳、吴升、涂平、肖桂荣、黄良振、张兴、王洪庆。

II

DB35/T1884—2019

引言

2018年4月22日至4月24日，“以信息化驱动现代化，加快建设数字中国”为主题的首届数字中国建

设峰会于在福建省福州市举行。由福建省数字福建建设领导小组办公室推荐的“数字福建政务数据整合

汇聚与共享应用工程”作为30个最佳实践案例之一在峰会期间对外展示。

政务数据汇聚标准系列，采用模块化方法进行编制，包括核心标准和扩展标准。核心标准包括数据

集规范化描述和核心接口描述。其中DB35/T1777—2018《政务数据汇聚：数据集规范化描述》规定了

政务数据汇聚所形成数据集内容和形式的规范化描述，人口、法人等数据扩展规范可在此基础上参照定

制。政务数据汇聚的核心接口是政务数据汇聚工程开发和测试过程中的主要操作接口，包括服务描述、

数据描述和数据描述，具体传输协议（如Post、SOAP、Restful）扩展、订阅推送等操作扩展可在核心

接口描述的基础上参照定制。

III

DB35/T1884—2019

政务数据汇聚核心接口描述

1范围

本标准规定了政务数据汇聚的核心接口操作描述、接口扩展描述、错误代码和接口返回格式。

本标准适用于政务数据汇聚核心接口的开发、测试。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T7408—2005数据和交换格式信息交换日期和时间表示法

GB11643—1999公民身份号码

GA/T2000.156—2016公安信息代码第156部分：常用证件代码

DB35/T1777—2018政务数据汇聚：数据集的规范化描述

《国务院关于批转发展改革委等部门法人和其他组织统一社会信用代码制度建设总体方案的通知》

（国发〔2015〕33号）

IETFRFC2616超文本传输协议—HTTP/1.1（HypertextTransferProtocol—HTTP/1.1）

3术语和定义

DB35/T1777—2018界定的以及下列的术语和定义适用于本文件。为了便于使用，以下重复列出了

DB35/T1777—2018中的一些术语和定义。

3.1

接口描述interfacedescription

描述通过接口交换所需要的全部信息。

注1：参见WSDL2.0。

注2：含操作、请求、返回、异常描述。

3.2

核心接口操作coreinterfacedescription

通过接口交换所需要的主要接口操作。

注：政务数据汇聚核心接口操作含服务描述操作、数据描述操作、数据采集操作。

3.3

服务描述操作servicedescriptionoperation

客户端发送服务描述请求，服务端返回服务描述。

3.4

数据描述操作datadescriptionoperation

客户端发送数据描述请求，服务端返回数据描述。

1

DB35/T1884—2019

3.5

数据采集操作getdataoperation

客户端发送数据采集请求，服务端返回数据集。

3.6

多重性multiplicity

包含一组上下限数，用来指出可被允许生成的实例。

注1：参见ISO/IEC19505-1:2012。

注2：0:1表示可选且不具有多重性，0:N表示可选且具有多重性，1:1表示必选且不具有多重性，1:N表示必选且

具有多重性，3:N表示至少有3个实例。

4缩略语

下列缩略语适用于本文件。

GDI：政务数据汇聚（GovernmentalDataIngestion）

JSON：JavaScript对象标记（JavaScriptObjectNotation）

KVP：键值对（KeyValuePair）

MIME：多用途互联网邮件扩展类型（MultipurposeInternetMailExtensions）

SOAP：简单对象访问协议（SimpleObjectAccessProtocol）

XML：可扩展标记语言（eXtensibleMarkupLanguage）

XSD：XML结构定义（XMLSchemasDefinition）

5核心接口操作描述

5.1总体要求

政务数据汇聚操作基于数据汇聚请求描述定制，数据汇聚请求描述参数包括服务类型和版本号，见

附录A中的表A.1。政务数据汇聚核心接口支持服务描述操作、数据描述操作和数据采集操作，政务数据

汇聚接口的应至少支持一种数据集描述格式和一种传输协议，如KVP、SOAP等，参见附录B。

5.2服务描述操作

服务描述操作请求参数包括服务类型、版本号和操作名称，见附录A中的表A.2。

服务描述操作返回结果包括服务描述元数据、服务操作元数据和服务内容，见附录A中的表A.3。

服务描述元数据包括服务名称、服务摘要、服务类型、服务版本、扩展配置、扩展服务描述、联系

信息（单位名称、联系人、电话、邮箱、地址），见附录A中的表A.4。

服务操作元数据包含操作名称、地址模版、扩展操作描述，见附录A中的表A.5。

服务内容包括数据集名称和扩展内容描述，见附录A中的表A.6。

5.3数据描述操作

数据描述操作请求参数见附录A中的表A.7，包括服务类型、版本号、操作名称和数据集名称。

数据描述操作返回结果包括数据描述和支持格式，其中数据描述按照DB35/T1777—2018的规定，

见附录A中的表A.8。

2

DB35/T1884—2019

5.4数据采集操作

数据采集操作请求参数见附录A中的表A.9，包括服务类型、版本号、操作名称、数据集名称、客户

类别、客户识别码、返回格式、时间范围、和参数扩展，其中时间格式按照GB/T7408—2005中第5章的

规定。

数据采集操作返回结果为与数据描述操作结果相一致的数据。

数据采集请求操作包括静态数据采集请求和动态数据采集请求：

a)对于静态数据，如请求中无起止时间，则返回所有数据；如有