DB14_T 2545-2022政府网站集约化平台 数据接口规范.pdf

ICS35.140CCS L 8114山西省地方标准DB 14/T 25452022政府网站集约化平台 数据接口规范2022-09-30 发布2022-12-30 实施山西省市场监督管理局发 布DB 14/T 25452022I目次前言.II1范围.32规范性引用文件.33术语和定义.34信息资源库.35信息资源元数据.46信息资源编码规则.57信息资源对接.5附录 A（规范性）接口清单.7DB 14/T 25452022II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由山西省政务信息管理局提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省电子政务信息标准化技术委员会归口。本文件主要起草单位：山西省人民政府办公厅政务信息中心、山西省信息产业技术研究院有限公司。本文件主要起草人：姚南、张青云、胡兴才、马志红、申利华、上官学奎、陈炜哲、徐卉、王志文、陆文瑞、王渊、邢玮琦。DB 14/T 254520223政府网站集约化平台 数据接口规范1范围本文件规定了政府网站的信息资源库、信息资源元数据、信息资源编码规则、信息资源对接等内容。本文件适用于省、市、县（区）政府网站集约化平台的建设。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 21063.3 政务信息资源目录体系 第3部分：核心元数据GB/T 21062.3 政务信息资源交换体系 第3部分：数据接口规范GB/T 21063.4 政务信息资源目录体系 第4部分：政务信息资源分类GB/T2260 中华人民共和国行政区划代码GB/T 34981.2-2017 机构编制统计及实名制管理系统数据规范 第2部分：代码集3术语和定义下列术语和定义适用于本文件。3.1政府网站各级政府及其部门、派出机构和承担行政职能的事业单位在互联网上开办的，具有信息发布、解读回应、办事服务、互动交流等功能的网站。3.2政府网站集约化平台通过统一标准体系、统一技术平台、统一安全防护、统一运维监管、集中管理信息数据、集中提供内容服务，将一定范围内的政府网站集中到一起，形成资源优化融合、平台整合安全、数据互认共享、管理统筹规范的政府网站一体化平台。3.3政府网站统一信息资源库指通过一定规则对政府网站信息资源进行统一入库存储、维护管理、监管分析，并对外提供信息汇聚、数据转换、交换共享等服务的资源管理平台。4信息资源库4.1政务信息资源共享原则政务信息资源共享遵循以下原则：DB 14/T 254520224a)以共享为原则，不共享为例外；b)需求导向，无偿使用；c)统一标准，统筹建设；d)建立机制，保障安全。4.2信息资源库层级关系统一信息资源库分省、市两级建设，省级信息资源库数据资源覆盖各市，并向各市开放统一的数据接口。市级信息资源库应与省级信息资源库对接。4.3信息资源范围统一信息资源库入库资源信息范围包括但不限于：各级单位可提供的政策文件、站点内容信息、办事服务信息、结果公示信息等。4.4信息资源库功能信息资源库功能包括但不限于：信息资源采集、处理、存储、分析、监管等。5信息资源元数据5.1核心元数据5.1.1分类信息资源核心元数据包括10个必选元数据和3个可选元数据。5.1.2必选元数据信息资源代码、信息资源名称、信息资源发布日期、信息资源提供方、信息资源提供方代码、信息资源摘要、信息资源分类、信息资源格式、信息资源共享属性（共享类型、共享条件、共享方式）、信息资源开放属性。5.1.3可选元数据信息资源标签、信息资源覆盖范围、信息资源更新周期。5.2扩展元数据5.2.1提出与添加扩展元数据应由需求主办单位提出，由集约化平台运营方统一定义并添加，扩展元数据应满足当前阶段的应用需求和未来可能产生的标准化需求，在全省范围内使用。5.2.2要求扩展元数据要求包括但不限于：a)新建的元数据不应与本规范定义的核心元数据中现有的元数据实体、元素、代码、定义相冲突；DB 14/T 254520225b)增加的元数据元素应按照本规范所确定的层次关系进行合理的组织。如果本规范现有的元数据实体无法满足新增元数据的需要，则可以新建元数据实体；c)扩展的元数据实体或元素应按本规范定义中文名称、数据类型、最大出现次数，并给出示例；d)扩展的元数据元素可组成新的基本数据类型，但不能成为核心元数据类型。6信息资源编码规则6.1信息资源代码结构信息资源代码结构由前段码和后段码组成用“/”隔开。6.2前段码分为类、项、目、细目、基础分类共5个级次，合计23位阿拉伯数字。具体如下：a)类编码根据国家政务信息共享平台编目体系，统一使用阿拉伯数字“3”代表“部门信息资源类”；b)项编码根据国家政务信息共享平台编目体系，统一使用阿拉伯数字“07”代表“省(自治区、直辖市和计划单列市)”；c)目编码根据国家政务信息共享平台编目体系，共三位，原则上用阿拉伯数字表示；d)属地编码按照 GB/T 2260 规定的行政区划代码规则进行编码，如：太原市“140100”表示；e)业务部门编码按照 GB/T 34981.2 规定的机构编制代码规则进行编码，共三位，用阿拉伯数字表示；f)基础分类目录编码用 8 位阿拉伯数字表示。6.3后段码后段码使用9位流水号，用于表示同一信息资源细目分类下的不同信息资源。6.4编码方式图 1信息资源编码结构图7信息资源对接DB 14/T 254520226资源库提供多种资源对接方法，包括新增、修改、查询权限范围内的信息资源等，支持按照资源的元数据信息、关键词、时间、机构、智能标记等复杂条件查询。资源对接方法包括但不限于通过Restful/Web Service 等数据接口方式实现省、市两级信息资源库对接。信息资源可采用实时交换和导入导出方式进行对接。接口清单及示例见附录。DB 14/T 254520227AA附录A（规范性）接口清单接口名称接口描述申请 token当调用方调用资源库开放的接口时，需要 token 验证，调用方通过此接口获取 token获取标准获取调用方在资源库授权的标准列表，用于进一步获取分类树和获取资源获取分类根据标准，获取调用方在资源库授权的分类树获取表根据标准，获取调用方在资源库授权的资源列表获取映射关系获取调用方数据字段和资源库资源字段的映射关系数据入库调用方向资源库推送数据获取资源和分类下数据列表获取资源库特定分类、特定资源下的数据列表获取数据获取资源库数据详情信息获取资源数据图片、视频和附件列表获取资源库特定分类、特定资源下的图片、视频和附件列表消息队列资源库会发送数据新增和删除、上报、下达信息，供调用方消费后对数据进行相关操作DB 14/T 254520228示例：新增数据资源示例当调用方系统向资源库指定的分类和指定的资源推送资源数据时，调用本接口。请求地址：http:/资源库地址/uirb.translator/standards/resources/data请求方式：POST参数参数名称说明类型是否必填请求参数：tableName表名。Long必填CategoriesCMS 分类 ID 信息，CHANNELID：栏目 ID，DEPTI D：组织、机构 ID，CUSTOMKEY1:自定义数据表表英 文名（需要严格区分大小写）。示例：CHANNELID:1,2,3,DEPTID:1,2,3,CUSTOMKEY1:1,2,3String必填DataCategory所属分类String必填String必填Label所属标签String选填data_sources数据来源String必填data_sources_url数据来源 urlString选填source_code资源编码String必填save_time入库时间Timestamp必填create_user创建人String选填create_time创建时间Timestamp选填publish_user发布人String选填publish_time发布时间Timestamp选填update_user操作人String选填update_time操作时间Timestamp选填is_delete是否被删除String选填sys_update_user更新人String选填sys_update_time更新时间Timestamp选填新增资源数据 JSON 字符串appId应用 IDLong必填appHost调用方域名或 IPString必填Push是否上报。1-是，0-否int必填Distribution是否下达。1-是，0-否int必填userName当前用户的用户名String必填dataSourcesUrl数据来源 URLString选填Id数据 IDLong必填siteId站点 IDString必填access_tokentokenString必填请求示例：curl-X POST http:/资源库地DB 14/T 254520229址/uirb.translator/standards/resources/data?access_token=c50d6a9c-ba02-46b1-9325-b98fc7d48bbf-F tableName=GovDocNews-FappId=72-Fpush=0-F distribution=0-F userName=admin-F appHost=http:/ip-F data=id:12,title:测试文档入库,doccontent:文档正文-F categories=1,2,3返回值：JSON返回参数：参数名称类型说明dataIdLong数据 ID返回数据示例（成功）：msg:操作成功,data:dataId:851,isSuccess:trueDB 14/T 2545202210示例：获取映射关系示例当调用方系统从资源库导入资源数据时，获取调用方系统与统一资源库字段映射关系，调用本接口。请求地址：http:/资源库地址/uirb.translator/metadata/relation/tableName请求方式：GET参数参数名称说明类型是否必填路径参数：tableName调用方表名String必填请求参数：appId应用 IDLong必填access_tokentokenString必填请求示例：http:/资源库地址/uirb.translator/metadata/relation/GovDocNews?appId=72&access_token=xasxasxasqq-qwqw-qwqaassa返回值：JSON返回数据示例（成功）：msg:,/返回信息code:200,/状态码data:/数据集resourceId:11,/资源 IDcolumnRelations:/映射关系uirbDbColumnName:xxxxxNAME,/信息资源库资源表字段名称localDbColumnName:xxxxxNAME,/调用方资源表字段名localEntityAttrName:xxxxxNAME,/调用方资源模型属性名（实体属性名）primaryKey:true/是否为主键：false-否，true-是,standardId:11,/标准 IDlocalDbTableEnName:uirb_11_11_resdata_context/调用方资源表英文名,success:true/状态