ICS 35.240 DB37 L 72 山 东 省 地 方 标 准 DB 37/T 3522—2019 政务信息资源 数据交换规范 Government information resources—Data shared exchange specification 2019 - 03 - 21 发布 山东省市场监督管理局 2019 - 04 - 21 实施 发 布 DB37/T 3522—2019 目 次 前言 ................................................................................ II 1 范围 ............................................................................... 1 2 规范性引用文件 ..................................................................... 1 3 定义和术语 ......................................................................... 1 4 缩略语 ............................................................................. 1 5 交换方式 ........................................................................... 2 5.1 5.2 5.3 5.4 概述 ........................................................................... 服务接口 ....................................................................... 库表交换 ....................................................................... 文件交换 ....................................................................... 2 2 4 4 6 交换流程 ........................................................................... 5 6.1 6.2 6.3 6.4 总流程 ......................................................................... 服务接口 ....................................................................... 库表交换 ....................................................................... 文件交换 ....................................................................... 5 6 6 6 7 交换安全 ........................................................................... 6 附 录 A （规范性附录） 接口调用返回码定义 .......................................... 8 附 录 B （资料性附录） 服务接口描述信息填写示例 .................................... 9 参考文献 ............................................................................ 10 I DB37/T 3522—2019 前 言 本标准按GB/T 1.1—2009给出的规则起草。 本标准由山东省大数据局提出、归口并监督实施。 本标准起草单位：山东省大数据局、山东省人民政府办公厅、山东省计算中心（国家超级计算济南 中心）、山东省大数据中心、山东省标准化研究院。 本标准主要起草人：桓德铭、李学民、王传伟、綦琳、刘烨、赵硕、陈洪波、闫雷、逄锦山、张媛、 史丛丛、黄明胜、陈玉平、李刚、柯林森、李明、赵一新、刘晓飞、李敏。 II DB37/T 3522—2019 政务信息资源 数据交换规范 1 范围 本标准规定了政务信息资源的交换方式、交换流程和交换安全要求。 本标准适用于政务信息资源的数据交换。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 3304—1991 中国各民族名称的罗马字母拼写法和代码 GB/T 2261.1—2003 个人基本信息分类与代码 第1部分：人的性别代码 DB37/T 3520—2019 政务数据资源体系 总体架构 DB37/T 3521.1—2019 政务信息资源目录 第1部分：编码规则 3 定义和术语 下列定义和术语适用于本文件。 3.1 政务信息资源 government affairs information resources 政务部门在履行职责过程中制作或获取的，以一定形式记录、保存的文件、资料、图表和数据等各 类信息资源，包括政务部门直接或通过第三方依法采集的、依法授权管理的和因履行职责需要依托政务 信息系统形成的信息资源等。 [DB/T 3520—2019，定义3.1] 3.2 信息资源代码 information resource code 用于唯一标识政务信息资源的一组字符。 [DB/T 3521.1—2019，定义3.3] 3.3 交换 exchange 信息资源提供方和信息资源需求方间通过政务信息资源共享交换平台实现政务信息资源在线传送 的过程。 4 缩略语 1 DB37/T 3522—2019 下列缩略语适用于本文件。 HTTP：超文本传输协议(Hypertext Transfer Protocal) HTTPS：安全超文本传输协议(Secure Hypertext Transfer Protocal) 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。 表1 接口分类代码 代码 分类名称 1 查询类 2 验证类 3 数据传输类 4 下载类 9 其他类 2 DB37/T 3522—2019 5.2.2.3 接口代码 服务接口代码由接口提供方代码、政务信息资源代码、接口分类代码和接口顺序码四部分组成，代 码结构见图1。 图1 服务接口代码结构 服务接口代码编码规则如下： a) 第 1 位为接口提供方代码，使用 1 位大写英文字母表示，“T”标识资源提供方开发接口，“P” 标识共享交换平台统一开发接口； b) 第 2～13 位为政务信息资源代码，使用 12 位阿拉伯数字表示，采用 DB37/T 3521.1—2019 信 息资源代码的后 12 位，编码范围从 000001000001～999999999999； c) 第 14 位为接口分类代码，使用 1 位阿拉伯数字表示，编码范围为 1～9，分类代码见 5.2.2.2 节； d) 第 15～16 位为接口顺序码，使用 2 位阿拉伯数字表示，用于标识同一接口分类下的接口顺序， 编码范围为 01～99。 5.2.3 技术要求 服务接口技术要求包括但不限于： a) 服务传输协议：应符合 HTTP/HTTPS 1.0/1.1 标准； b) 服务消息协议：WebService 服务消息封装应符合 SOAP 1.1/1.2 标准；REST 服务消息封装应符 合 HTTP 1.0/1.1 标准； c) 服务描述要求：服务描述的内容格式应符合 WSDL 1.1、SOAP 1.1/1.2 标准。 5.2.4 开发要求 服务接口包括共享交换平台和提供方开发的接口。共享交换平台开发的接口应由需求方提出申请， 提供方提供系统IP地址、用户名、密码、接口功能名称等信息，并由共享交换平台接口开发人员编写需 求文档。服务接口开发要求包括但不限于： a) 接口名称：接口的中文名称应符合 5.2.2.1 的规定。 b) 接口方式：一般包括 WebService 和 REST 两种方式，若为 REST 方式，应标明 REST 操作。 c) 接口方