ICS 01.040.35 L 72 DB35 福 建 省 地 方 标 准 DB35/T 1884—2019 政务数据汇聚 核心接口描述 Governmental data ingestion — Core interface description specification 2019 - 12 - 19 发布 福建省市场监督管理局 2020 - 03 - 19 实施 发 布 DB35/T 1884—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/T 1884—2019 前 言 本标准按照GB/T 1.1—2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由数字中国研究院（福建）提出。 本标准由福建省信息化标准化技术委员会（SAFJ/TC 11）归口。 本标准起草单位：数字中国研究院（福建）、福建工程学院、福建省标准化研究院、福州大学、 福建省星云大数据应用服务有限公司、福建省政府办公厅电子政务中心、福大经纬信息科技有限公司。 本标准主要起草人：余劲松弟、佟瑞菊、文芳、吴升、涂平、肖桂荣、黄良振、张兴、王洪庆。 II DB35/T 1884—2019 引 言 2018年4月22日至4月24日，“以信息化驱动现代化，加快建设数字中国”为主题的首届数字中国建 设峰会于在福建省福州市举行。由福建省数字福建建设领导小组办公室推荐的“数字福建政务数据整合 汇聚与共享应用工程”作为30个最佳实践案例之一在峰会期间对外展示。 政务数据汇聚标准系列，采用模块化方法进行编制，包括核心标准和扩展标准。核心标准包括数据 集规范化描述和核心接口描述。其中DB35/T 1777—2018《政务数据汇聚：数据集规范化描述》规定了 政务数据汇聚所形成数据集内容和形式的规范化描述，人口、法人等数据扩展规范可在此基础上参照定 制。政务数据汇聚的核心接口是政务数据汇聚工程开发和测试过程中的主要操作接口，包括服务描述、 数据描述和数据描述，具体传输协议（如Post、SOAP、Restful）扩展、订阅推送等操作扩展可在核心 接口描述的基础上参照定制。 III DB35/T 1884—2019 政务数据汇聚 核心接口描述 1 范围 本标准规定了政务数据汇聚的核心接口操作描述、接口扩展描述、错误代码和接口返回格式。 本标准适用于政务数据汇聚核心接口的开发、测试。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 7408—2005 数据和交换格式 信息交换 日期和时间表示法 GB 11643—1999 公民身份号码 GA/T 2000.156—2016 公安信息代码 第156部分：常用证件代码 DB35/T 1777—2018 政务数据汇聚：数据集的规范化描述 《国务院关于批转发展改革委等部门法人和其他组织统一社会信用代码制度建设总体方案的通知》 （国发〔2015〕33号） IETF RFC 2616 超文本传输协议—HTTP/1.1（Hypertext Transfer Protocol—HTTP/1.1） 3 术语和定义 DB35/T 1777—2018界定的以及下列的术语和定义适用于本文件。为了便于使用，以下重复列出了 DB35/T 1777—2018中的一些术语和定义。 3.1 接口描述 interface description 描述通过接口交换所需要的全部信息。 注1：参见 WSDL 2.0。 注2：含操作、请求、返回、异常描述。 3.2 核心接口操作 core interface description 通过接口交换所需要的主要接口操作。 注：政务数据汇聚核心接口操作含服务描述操作、数据描述操作、数据采集操作。 3.3 服务描述操作 service description operation 客户端发送服务描述请求，服务端返回服务描述。 3.4 数据描述操作 data description operation 客户端发送数据描述请求，服务端返回数据描述。 1 DB35/T 1884—2019 3.5 数据采集操作 get data operation 客户端发送数据采集请求，服务端返回数据集。 3.6 多重性 multiplicity 包含一组上下限数，用来指出可被允许生成的实例。 注1：参见 ISO/IEC 19505-1:2012。 注2：0:1 表示可选且不具有多重性，0:N 表示可选且具有多重性，1:1 表示必选且不具有多重性，1:N 表示必选且 具有多重性，3:N 表示至少有 3 个实例。 4 缩略语 下列缩略语适用于本文件。 GDI：政务数据汇聚（Governmental Data Ingestion） JSON：JavaScript对象标记（JavaScript Object Notation） KVP：键值对（Key Value Pair） MIME：多用途互联网邮件扩展类型（Multipurpose Internet Mail Extensions） SOAP：简单对象访问协议（Simple Object Access Protocol） XML：可扩展标记语言（eXtensible Markup Language） XSD：XML结构定义（XML Schemas Definition） 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/T 1777—2018的规定， 见附录A中的表A.8。 2 DB35/T 1884—2019 5.4 数据采集操作 数据采集操作请求参数见附录A中的表A.9，包括服务类型、版本号、操作名称、数据集名称、客户 类别、客户识别码、返回格式、时间范围、和参数扩展，其中时间格式按照GB/T 7408—2005中第5章的 规定。 数据采集操作返回结果为与数据描述操作结果相一致的数据。 数据采集请求操作包括静态数据采集请求和动态数据采集请求： a) 对于静态数据，如请求中无起止时间，则返回所有数据；如有开始时间而无终止时间，则返回 从开始时间之后所有数据；如有起止时间，则返回起止时间范围内数据，如无开始时间而有终 止时间，则返回从开始时间之后至终止时间范围内的所有数据； b) 对于动态数据，如请求中无起止时间，则当前更新数据持续返回；如有开始时间而无终止时间， 则取开始时间至当前时间范围内数据，后续数据按数据更新持续返回；如有起止时间，则返回 起止时间范围内数据，如无开始时间而有终止时间，则返回从开始时间之后至终止时间范围内 的所有数据。 6 接口扩展描述 6.1 核心接口扩展 6.1.1 扩展方式 接口扩展应与数据汇聚抽象请求描述及DB35/T 1777—2018保持一致，有以下两种方式： a) 基于核心操作，增加扩展参数并定制返回内容和格式； b) 基于数据汇聚请求定义新操作，包括操作参数及返回内容和