ICS 35.240.01 CCS L 67 黑 DB23 龙 江 省 地 方 标 准 DB23/T 2842-2021 政务信息资源数据交换规范 2021 - 04 - 13 发布 黑龙 江省 市场 监督管 理局 2021 - 05 - 12 实施 发布 DB23/T 2842-2021 2 DB23/T 2842-2021 前  言 本文件按照GB/T 1.1-2020给出的规则起草。 本文件由黑龙江省营商环境建设监督局提出并归口。 本文件起草单位：黑龙江省营商环境监督监督局、黑龙江省政务大数据中心、黑龙江省标准化研究 院。 本文件主要起草人：史春光、何振江、曹占立、岳伟强、贾立红、张宪凯、梅兵、王颖、陈冬冰、 陈要武、杨大志、吕猛、王磊、李严、王艳君。 I DB23/T 2842-2021 政务信息资源数据交换规范 1 范围 本文件规定了黑龙江省政务信息资源数据交换的通用要求，描述了相应的交换方式、交换流程和交 换安全等。 本文件适用于黑龙江省政务信息资源的数据交换。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 2261.1 个人基本信息分类与代码 第1部分：人的性别代码 GB/T 3304 中国各民族名称的罗马字母拼写法和代码 GB/T 21063.5 政务信息资源目录体系 第5部分：政务信息资源标识符编码方案 DB23/T 2839 政务信息资源目录 第1部分：编码规则 DB23/T 2843 政务信息资源体系 总体架构 3 术语和定义 DB23/T 2843界定的以及下列术语和定义适用于本文件。 3.1 信息资源代码 用于唯一标识政务信息资源的一组字符。 3.2 交换 信息资源提供方和信息资源需求方之间通过政务信息资源共享交换平台实现政务信息资源在线传 送的过程。 3.3 信息资源提供方 通过政务信息资源共享交换平台提供政务信息资源的各级政务部门。 3.4 信息资源需求方 1 DB23/T 2842-2021 通过政务信息资源共享交换平台获取政务信息资源的各级政务部门。 4 缩略语 下列缩略语适用于本文件。 HTTP：超文本传输协议(Hypertext Transfer Protocol) HTTPS：安全超文本传输协议(Secure Hypertext Transfer Protocol) WSDL：Web服务描述语言(Web Services Description Language) SOAP：简单对象访问协议(Simple Object Access Protocol) REST：表述性状态传递(Representational State Transfer) UTF-8：Unicode的可变长度字符编码(8-bit Unicode Transformation Format) 5 交换方式 5.1 概述 信息资源提供方和信息资源需求方通过政务信息资源共享交换平台实现政务信息资源的交换。数据 交换方式包括但不限于： a) 接口方式：通过服务接口实现数据交换或功能调用，适用于实时性和灵活性要求较高、数据量 较小的数据交换； b) 库表方式：以数据库表结构形式的交换方式，适用于体量大、数据增量更新频繁的数据交换； c) 文件方式：通过文件发送的方式将规范化的数据文件传送到指定的交换节点，适用于非结构化 数据或更新较缓慢的结构化数据的交换。 5.2 服务接口 5.2.1 设计原则 服务接口设计的基本原则包括但不限于： a) 安全性原则：提供多种安全可靠的技术手段，保证接口数据的安全； b) 开放性原则：采用通用的接口设计标准，保证与其他系统的互联互通； c) 灵活性原则：能根据业务变化，灵活调整接口容量与性能； d) 松耦合原则：避免接口服务的实现对提供方业务系统的依赖性。 5.2.2 5.2.2.1 基本要求 接口名称 接口名称采用中文名称，由提供方名称、资源名称和接口分类三部分组成。提供方名称宜使用国家 规定的部门简称。 示例：黑龙江省公安厅简称为省公安厅。 5.2.2.2 接口分类 接口分为查询类、验证类、数据传输类、下载类及其它类，接口分类代码见表1。 2 DB23/T 2842-2021 表1 5.2.2.3 接口分类代码 代码 分类名称 1 查询类 2 验证类 3 数据传输类 4 下载类 9 其他类 接口代码 5.2.2.3.1 服务接口代码由接口提供方代码、政务信息资源代码、接口分类代码和接口顺序码四部分 组成，代码结构见图 1。 图1 服务接口代码结构 5.2.2.3.2 服务接口代码编码规则 服务接口代码编码规则如下： a) 接口提供方代码，使用 1 位大写英文字母表示，“T”标识资源提供方开发接口，“P”标识共 享交换平台统一开发接口； b) 政务信息资源代码，使用阿拉伯数字表示，具体见黑龙江省地方标准-政务信息资源目录第 1 部分：编码规则； c) 接口分类代码，使用 1 位阿拉伯数字表示，编码范围为 1～9，分类代码见 5.2.2.2 节； d) 接口顺序码，使用 2 位阿拉伯数字表示，用于标识同一接口分类下的接口顺序，编码范围为 01～99。 5.2.3 技术要求 服务接口技术要求包括但不限于： a) 服务传输协议：符合 HTTP/HTTPS 1.0/1.1 标准； WebService 服务消息封装符合 SOAP1.1/1.2 标准；REST 服务消息封装符合 HTTP b) 服务消息协议： 1.0/1.1 标准； c) 服务描述要求：服务描述的内容格式符合 WSDL 1.1、SOAP 1.1/1.2 标准。 3 DB23/T 2842-2021 5.2.4 开发要求 服务接口包括共享交换平台和提供方开发的接口。共享交换平台开发的接口由需求方提出申请，提 供方提供系统IP地址、用户名、密码、接口功能名称等信息，并由共享交换平台接口开发人员编写需求 文档。服务接口开发要求包括但不限于： a) 接口名称：接口的中文名称符合 5.2.2.1 的规定； b) 接口方式：一般包括 WebService 和 REST 两种方式，若为 REST 方式，标明 REST 操作； c) 接口方法：命名采用大小写混合的形式，以小写字母开头，名称中其他单词的首字母以大写字 母开头，不宜使用下划线分割单词； d) 接口测试：接口对共享交换平台开放测试权限，并提供测试用例； e) 接口授权：提供方授权的接口明确管控参数 ApiKey； f) 接口参数： 1) REST 类型的服务接口，仅允许在 Header 里传入授权验证相关的参数，不允许使用共享交 换平台保留的参数名 AppKey、AppSecret、ApiKey、ApiSecret，POST 方式的接口支持在 Body 中传递 Application/JSON 格式的参数； 2) WebService 类型的服务接口，不允许在 Header 传递参数，在 Body 中传递； 3) 传递参数为中文字符时，采用 UTF-8 编码。 g) 返回数据： 1) 接口注册时标明接口的返回格式； 2) 返回数据采用固定的格式封装，一般为 xml、JSON 等； 3) 接口调用不通过，可通过返回码返回数据，接口调用返回码定义见附录 A。 5.2.5 发布要求 5.2.5.1 服务接口发布时，与政务信息资源目录相对应，并准确填写接口描述信息。接口描述信息包 括但不限于接口概述、接口名称、接口分类、接口方式、接口地址、接口授权、接口方法、输入输出参 数以及接口实例。接口主要描述信息填写要求包括但不限于： a) 接口概述：描述出接口提供方功能； b) 接口授权：明确服务授权方，包括共享交换平台和提供方； c) 输入参数：针对每个接口方法，给出参数名、参数说明、类型、约束等输入信息； d) 输出参数：针对每个接口方法，给出返回值格式等输出信息； e) 接口实例：提供方提供服务接口实例，标注返回参数含义等信息。 5.2.5.2 接口描述信息填写示例见附录 B。 5.2.6 服务更新 提供方若因业务变化，需对交换数据进行变更时，在不影响使用的原则下对已发布的服务接口更新， 接口更新时应保留原版本。服务接口更新要求包括但不限于： a) 应提前在本级共享交换平台进行更新备案，说明服务更新的计划停止时间、重新启动时间、变 更内容等； b) 避免在工作时间内进行服务接口更新； c) 避免变更输入、输出参数。 5.2.7 授权验证 通过共享交换平台分配的接口密钥、访问令牌等方式对调用服务申请进行授权验证。 4 DB23/T 2842-2021 5.3 库表交换 库表交换要求包括但不限于： a) 按照数据交换内容在提供方和需求方部署的前置服务器上安装数据库并创建数据库表； b) 提供方和需求方提前约定数据交换格式、交换频率、交换内容等； c) 需求方在共享交换平台填写申请资料时选定数据类型； d) 数据获取后，需求方对获取的入库时间、入库记录数量、交换数据来源等内容向提供方确认。 5.4 文件交换 文件交换方式应将无承载系统的资源，通过数据录入或数据导入的方式存入共享交换平台数据库表 中，由共享交换平台提供统一接口用于交换。数据录入方式，适用于非结构化数据和数据量较小的情况； 数据导入方式，仅适用于结构化数据。对于非结构化数据，无交换格式限制。对于结构化数据，支持xml、 xls、txt等格式文件。 6 6.1 交换流程 总流程 基于共享交换平台的资源共享交换总流程包括但不限于： a) 提供方整理可共享交换的资源，完成资源目录的编目与报送； b) 提供方在共享交换平台完成资源发布； c) 需求方通过共享交换平台进行检索，对所需的资源进行申请： 1) 对于无条件共享的资源，需求方在共享交换平台备案后获取资源； 2) 对于有条件共享的资源，需由提供方审核，审核通过后完成资源获取。 d) 提供方通过共享交换平台以接口、库表、文件等交换方式提供需求方所需资源； e) 需求方获取资源； f) 需求方对获取资源进行审核： 1) 若提供资源与所需资源一致，需求方可直接获取使用； 2) 若提供资源与所需资源不一致，需求方通过共享交换平台提交纠错意见，并提供政务信息 资源目录、信息资源格式类型、信息资源名称、问题描述、联系人、联系电话、邮箱等信 息，提供方通过共享交换平台查看纠错意见，并将意见反馈给需求方，需求方可重新申请 资源。交换总流程见图 2。 5 DB