DB21-T 4046-2024 公共数据开放平台接入技术规范

ICS35.240.01CCSL7921TechnicalspecificatiIDB21/T4046—2024 2规范性引用文件 3术语和定义 4接入技术要求 4.1接入总体框架示意图 4.2网络环境要求 4.3接入要求 4.3.1目录接入 4.3.2资源接入 4.4接入流程 4.4.1未建开放平台接入流程要求 4.4.2已建开放平台接入流程要求 4.4.3前置库数据接入流程要求 4.4.4前置机准备阶段 4.4.5数据抽取阶段 4.4.6数据质量确认阶段 4.4.7数据挂载阶段 5接口规范要求 5.1接口基本要求 5.1.1通讯协议 5.1.2消息头 5.1.3消息体 5.1.4返回内容 5.2接口设计描述 5.2.1数据目录接入描述 5.2.2数据资源接入描述 6安全措施要求 6.1平台安全要求 DB21/T4046—20246.1.1认证授权要求 6.1.2安全审计要求 6.2数据安全要求 6.2.1数据传输要求 6.2.2数据加密要求 6.2.3安全管理要求 附录A（规范性）省公共数据开放目录数据项填报说明 附录B（资料性）资源挂载要求 附录C（资料性）接口设计描述 DB21/T4046—2024本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由辽宁省数据局提出并归口。本文件起草单位：辽宁省数据中心。本文件主要起草人：丛明、兰莹、张丽霞、蒲云鹏、李洪涛、孙醒坤、徐铁、任成刚、李雪、李国良、年晓非、苏乃锋、陈绍博、安玉兴、李宏岩、邵思豪、韩松、韩旭、李享、朱琳卓、冉令弘、杨志强、胡丹丹、王晓东。本文件发布实施后，任何单位和个人如有问题和意见建议，均可以通过来电或来函等方式进行反馈，我们将及时答复并认真处理，根据实际情况依法进行评估及复审。归口管理单位：辽宁省数据局，通讯地址：辽宁省沈阳市皇姑区崇山中路109号，联系电话起草单位：辽宁省数据中心，通讯地址：辽宁省沈阳市和平区市府大路187号328室，联系电话1DB21/T4046—2024公共数据开放平台接入技术规范本文件规定了辽宁省公共数据开放平台归集数据资源时的接入技术要求、接口规范要求和安全措施要求。本文件适用于指导省直部门、公共企事业单位及各市数据开放平台将数据接入至辽宁省公共数据开放平台。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T4754国民经济行业分类GB/T21062.2-2007政务信息资源交换体系第2部分：技术要求GB/T21062.4-2007政务信息资源交换体系第4部分：技术管理要求GB/T21063.4-2007政务信息资源目录体系第4部分：政务信息资源分类GB/T39443-2020公共信用信息交换方式及接口规范3术语和定义下列术语和定义适用于本文件。3.1公共数据开放publicdataopening向自然人、法人或非法人组织依法提供公共数据的行为。3.2公共数据开放平台publicdataopeningplatform社会公众获取政府及公共企事业单位开放数据的入口,是归集和发布可开放公共数据和提供数据开放服务的综合平台。3.3对接系统interconnectionsystem实现辽宁省公共数据开放平台与各市数据开放平台间数据交换的功能模块，分为省级对接系统和市级对接系统。3.4公共数据开放目录publicdataopeningcatalog以核心元数据为主要描述方式，按照资源分类索引和目录条目格式的要求，将数据库中不同类型、不同层次的数据按照一定的分类体系进行编目，用以描述数据的特征，实现数据检索、定位与获取的目录。DB21/T4046—20243.5公共数据开放资源publicdataopeningresource数据提供方面向社会开放的具备原始性、可机器读取和可进行社会化开发利用的数据集。3.6接入access公共数据在计算机网络环境下从一个节点到其他节点的传送和处理过程，包括目录接入和资源接入。4接入技术要求4.1接入总体框架示意图省数据开放平台主要接入省直部门、公共企事业单位及各市数据开放平台提供的公共数据开放目录和公共数据开放资源。接入总体框架示意图如图1所示。图1接入总体框架示意图4.2网络环境要求4.2.1具备电子政务外网环境的省直部门、公共企事业单位及各市数据开放平台，可通过电子政务外网实现数据接入。4.2.2不具备电子政务外网环境的公共企事业单位，在互联网环境下可通过省数据开放平台的数据接入功能实现数据接入。23DB21/T4046—20244.3接入要求4.3.1目录接入公共数据开放目录数据项包括目录分类、数据资源名称、数据提供方、数据资源摘要、数据格式、数据项信息、开放属性和更新周期等，按照附录A要求。公共数据开放目录接入如下：a)已建数据开放平台的接入方式：包括服务接口接入和前置库接入。服务接口接入是以REST服务作为省数据开放平台与数据提供方之间数据推送的接口，通过市级对接系统、省级对接系统实现公共数据开放目录的实时接入；前置库接入是指当数据提供方接入开放数据的目录条数较多且更新频率较低时，通过前置库对数据进行批量交换，实现公共数据开放目录的接入；b)未建数据开放平台的接入方式：对未建设数据开放平台的省直部门、公共企事业单位及各市均可通过数据挂载的方式接入省数据开放平台。4.3.2资源接入数据提供方应根据接入资源类型，执行对应的接入要求，具体如下：a)文件资源：当数据提供方以文件方式挂载资源时，需提供的核心数据项参见附录B的B.1；b)库表资源：当数据提供方以库表方式挂载资源时，需提供的核心数据项参见附录B的B.2；c)接口资源：当数据提供方以REST或WebService方式挂载资源时，需提供的核心数据项参见d)链接资源：当数据提供方以链接方式挂载资源时，需提供的核心数据项参见附录B的B.4。4.4接入流程4.4.1未建开放平台接入流程要求使用省数据开放平台进行目录和资源的挂载。4.4.2已建开放平台接入流程要求接入流程如下：a)前置库数据接入流程要求见本文件4.4.3；b)市数据开放平台按照接口设计要求应符合本文件5.2的要求。4.4.3前置库数据接入流程要求前置库数据接入流程如图2所示，省数据开放平台及数据提供方按照GB/T21062.4-2007管理环节部分的要求执行，完成各阶段工作。4DB21/T4046—2024图2数据接入流程图4.4.4前置机准备阶段前置机准备阶段包括部署前置机服务、分配前置机账号、初始化数据分区和添加数据至前置库，前置机中应安装如下软件：a)安装交换节点软件，用于发送和接收数据；b)安装前置数据库软件，在业务库表结构的基础上创建数据交换表。5DB21/T4046—20244.4.5数据抽取阶段数据抽取阶段包括部署数据抽取程序和抽取数据，技术要求按照GB/T21062.2-2007前置交换子系统部分的要求执行：a)时间戳：通过时间戳字段标记数据的更新时间；b)标识位：通过标识位字段标记数据是否已经被抽取，在完成数据抽取后修改该标识位，实现数据增量交换；c)全量交换：一次性将数据库表中的所有数据交换到目标节点，业务库表应具有主键标识。4.4.6数据质量确认阶段数据接收方、数据提供方应按照如下要求进行数据质量确认和数据报送：a)数据接收方按照准确性、完整性和一致性要求，对数据质量进行确认；b)数据提供方针对不符合要求的数据，应该进行优化后再次报送。4.4.7数据挂载阶段数据提供方应根据可开放数据的资源类型，按照对应资源接入要求进行数据挂载，公共数据开放资源接入要求应符合本文件4.3.2要求。5接口规范要求5.1接口基本要求5.1.1通讯协议本标准通讯协议按照GB/T39443-2020接口要求执行，具体要求如下：a)数据承载使用REST风格（PUT/POST/DELETE方法）,由消息请求方发送请求，由消息接收方回复响应；b)所有JSON消息中的字段均为小写；c)所有消息中的JSON数据均采用UTF-8编码。5.1.2消息头HTTPHeader消息头包含字段见表1。表1消息头字段说明序号属性名称约束类型字符长度取值说明1opendata_uid必选string请求者身份标识2opendata_ctime必选string服务调用时间戳3opendata_sign必选string签名信息提供方；“服务调用时间戳”需精确到秒级；“签名信息”由请求者身份标识、身份密钥和服务调用时间戳3项信息加6DB21/T4046—20245.1.3消息体消息体为具体传输内容，将所有必填和选填内容合并成JSON数据，在发送请求时，和消息头一起传输。5.1.4返回内容接口返回内容均为JSON格式，返回内容说明见表2。表2发送请求返回内容说明序号元素名称约束类型字符长度取值说明1code必选string返回消息的状态码2msg必选string返回消息结果描述3data必选----返回消息体5.2接口设计描述5.2.1数据目录接入描述数据提供方应根据数据目录分类，执行对应目录接口设计描述要求，具体如下：a)数据目录注册接口设计描述参见附录C的C.1；b)数据目录变更接口设计描述参见附录C的C.2；c)数据目录撤销接口设计描述参见附录C的C.3。5.2.2数据资源接入描述数据提供方应根据数据资源分类，执行对应资源接口设计描述要求，具体如下：a)服务资源注册接口设计描述参见附录C的C.4；b)服务资源变更接口设计描述参见附录C的C.5；c)服务资源撤销接口设计描述参见附录C的C.6；d)服务资源附件上传接口设计描述参见附录C的C.7；e)服务资源附件删除接口设计描述参见附录C的C.8；f)链接资源注册接口设计描述参见附录C的C.9；g)链接资源变更接口设计描述参见附录C的C.10；h)链接资源撤销接口设计描述参见附录C的C.11。6安全措施要求6.1平台安全要求6.1.1认证授权要求数据接入应采用账号密码等认证和授权措施，对数据传输两端进行身份鉴别，确保认证身份数据双方可信任，采用校验技术或密码技术，保证身份认证数据在传输过程中的完整性、保密性。6.1.2安全审计要求7DB21/T4046—2024数据提供方应具备审计机制和功能。针对数据接入过程中的数据新增、变更、删除、查询留存审计记录，实现审计记录可追溯。6.2数据安全要求6.2.1数据传输要求数据传输要求如下：a)服务接口、服务代理应支持HTTPS协议；b)数据开放接口应采用防篡改等技术，保证数据的安全性和完整性；c)在传输数据时，应使用符合国家密码管理部门要求的加密协议，保证数据在传输过程中的安全性。6.2.2数据加密要求对重要数据采用符合国家密码管理部门要求的算法进行数据加密，保证数据的安全性。6.2.3安全管理要求安全管理要求如下：a)数据提供方应建立内部审批机制，完成信息保密审查后，对拟开放的数据脱敏、匿名化、去标识化处理；b)数据提供方应对数据全生命周期的操作规范、保护措施、管理人员职责等进行规定；c)数据提供方应按照最小授权原则对数据操作和系统访问等进行权限管理。8DB21/T4046—2024省公共数据开放目录数据项填报说明A.1公共数据开放目录数据项公共数据开放目录数据项填报模板见表A.1，其中带“*”项为核心必填数据项。表A.1公共数据开放目录数据项***发布日期*所属行业所属主题方*门***数据项描述****开放条件9DB21/T4046—2024A.2重点领域名称重点领域名称见表A.2。表A.2重点领域名称123456789DB21/T4046—2024A.3行业名称行业名称见表A.3，采用的行业名称按照GB/T4754执行。表A.3行业名称123456789DB21/T4046—2024A.4主题名称主题名称见表A.4，采用的主题名称按照GB/T21063.4-2007的主题分类类目执行。表A.4主题名称123456789DB21/T4046—2024A.5数据资源格式类型数据资源格式类型见表A.5。表A.5数据资源格式类型123456789DB21/T4046—2024表A.5(续)A.6数据资源格式分类数据资源格式分类见表A.6。表A.6数据资源格式分类DB21/T4046—2024A.7数据类型数据类型见表A.7。表A.7数据类型123456789A.8敏感级别敏感级别见表A.8。表A.8敏感级别123数据泄露后会对个人、法人、其他组织或国家机4DB21/T4046—2024A.9更新周期更新周期见表A.9。表A.9更新周期12345678DB21/T4046—2024资源挂载要求B.1文件资源核心数据项文件资源核心数据项见表B.1。表B.1文件资源核心数据项JPG,GIF,PNG,TXT,DOC,DOCX,PDF,XLS,XLSX,CEB.2库表资源核心数据项库表资源核心数据项见表B.2。表B.2库表资源核心数据项DB21/T4046—2024B.3接口资源核心数据项接口资源核心数据项见表B.3。表B.3接口资源核心数据项WebService服务的SoapHeader（接WebService服务的SoapBody（接入类型为WebServB.4链接资源核心数据项链接资源核心数据项见表B.4。表B.4链接资源核心数据项DB21/T4046—2024接口设计描述C.1数据目录注册接口示例数据目录注册接口示例见表C.1。表C.1数据目录注册接口示例是是是否是否2否是否否否是放否写否否是否DB21/T4046—2024表C.1（续）否否是否否否否否否否-是是是否是是否2否2否2否2否2否2否2否2否2否是2DB21/T4046—2024表C.1（续）{"cataCode":"83c20316ba0a47b39e"cataTitle":"建筑施工企业项目"cataTags":"企业,项目负责人,合格证书,施工,考核,安全生产"description":"建筑施工企业项目负"itemId":"030241ca645246719"itemId":"1daf7ba0bf0d4f3aaDB21/T4046—2024表C.1（续）}返回HTTP状态4-{"cataId":"6c5f8a86cd8a43dda}DB21/T4046—2024C.2数据目录变更接口示例数据目录变更接口示例见表C.2。表C.2数据目录变更接口示例是是是是否是否2否是否否否是否否否是否否否DB21/T4046—2024表C.2（续）是否否否否否否否-是是是否是是否2否2否2否2否2否2否2否2否2否是2{"cataId":"bea8967bd8c5456ea"cataTags":"预报,空气质量,辽宁省,业务,城乡建设,DB21/T4046—2024表C.2(续)"itemId":"030241ca645246719"itemId":"1daf7ba0bf0d4f3aaDB21/T4046—2024表C.2（续）}返回HTTP状态4 {}DB21/T4046—2024C.3数据目录撤销接口示例数据目录撤销接口示例见表C.3。表C.3数据目录撤销接口示例是是是是{"cataId":"062240b20e0a4caea}返回HTTP状态4-{}DB21/T4046—2024C.4服务资源注册接口示例服务资源注册接口示例见表C.4。表C.4服务资源注册接口示例是是是是是否1否是否否否否否否否否否否DB21/T4046—2024表C.4（续）否否否否否否否否否否否{"serviceDesc":"根据证件号和证照名称查询证照url，通过url在浏览器中可以预览证照","cataId":"ca4f25667e534ef0aDB21/T4046—2024表C.4（续）"endpoint":":9980/resource/admin/resource}返回HTTP状态4-{"serviceId":"6c5f8a86cd8a43dd}DB21/T4046—2024C.5服务资源变更接口示例服务资源变更接口示例见表C.5。表C.5服务资源变更接口示例是是是是服务上报时，省数据开放平台返是是否1服务类型：0-数据服务；1-接入否是否否是否否服务调用保护参数，包括服务熔秒）executionTimeout、熔断采样时间窗口（毫秒）rollingSta否储否服务调用结果状态码，以JSON否DB21/T4046—2024表C.5（续）否否否否否否否否否否否否否否数据服务执行的SQL语句{"serviceId":"52141ef338794f65b"serviceName":"勘察、设计"serviceDesc":"勘察、设计"context":"/uploadApi/k"cataId":"ca4f25667e534ef0aDB21/T4046—2024表C.5（续）"endpoint":":9980/resource/admin/resource}返回HTTP状态4-{}DB21/T4046—2024C.6服务资源撤销接口示例服务资源撤销接口示例见表C.6。表C.6服务资源撤销接口示例是是是是{"serviceId":"062240b20e0a4caea24}返回HTTP状态4 {}DB21/T4046—2024C.7服务资源附件上传接口服务