ICS 35.240.99 CCS L 70 34 安 徽 省 地 方 标 准 DB34/T 4085—2021 政府网站信息资源库数据交换规范 Data exchange specifications for the government website information resources repository 2021-12-28 发布 2022-01-28 实施 安徽省市场监督管理局 发 布 DB34/T 4085—2021 前 言 本文件按照 GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由安徽省人民政府网管理中心提出。 本文件由安徽省信息技术标准化技术委员会（AH/TC25）归口。 本文件起草单位：合肥工业大学、安徽省人民政府网管理中心、宿州市数据资源管理局、安徽省质 量和标准化研究院、北京开普云信息科技有限公司。 本文件主要起草人：郭亚光、寿志勤、许君、汪敏、陶松、陆文星、张怀光、殷文正、彭祖剑、李 凯、季静、王静、徐多响。 I DB34/T 4085—2021 政府网站信息资源库数据交换规范 1 范围 本文件确立了政府网站信息资源库数据交换的基本要求，并规定了数据交换流程和数据交换接口的 要求。 本文件适用于政府网站信息资源库与政府网站集约化平台、政务服务平台、统一政府热线服务平台 等系统的数据交换。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 7408 数据元和交换格式信息交换 日期和时间表示法 GB/T 15278 信息处理 数据加密 物理层互操作性要求 GB/T 21062.3 政务信息资源交换体系 第3部分：数据接口规范 3 术语和定义 下列术语和定义适用于本文件。 3.1 接口使用方 user of data exchange interface 使用数据交换接口的组织。 3.2 接口提供方 supplier of data exchange interfaces 提供数据交换接口服务的组织。 3.3 平台运营方 operator of data exchange platform 为数据交换平台提供技术服务支撑的组织。 4 基本要求 4.1 包括资源服务、资源管理、资源同步等接口。 4.2 接口规范描述和开发应按照 GB/T 21062.3 的要求执行。 4.3 接口的时间、日期格式应按照 GB/T 7408 的要求执行； 4.4 接口应采用 Http/Https 接口访问方式，并用 XML Schema 对接口返回数据格式进行定义。 4.5 接口应支持跨防火墙的数据传输，并按照 GB/T 15278 的要求进行加密。 1 DB34/T 4085—2021 5 数据交换流程 数据交换流程见图1。 接口使用方 接口提供方 平台运营方 开始 申请提交 功能评估 安全评估 申请审核 开通授权 授权凭证反馈 验证 结束 数据交换流程 6 交换接口 6.1 资源服务接口 6.1.1 资源服务接口内容 资源服务接口包括但不限于以下类型。 a) 查询资源分类：通过接口可查询当前资源库的分类设定情况。 b) 分页查询元数据集：通过接口可分页查询当前资源库的元数据集设定情况。 c) 分页查询元数据：通过接口可分页查询当前资源库的元数据设定情况。 d) 根据元数据集 ID 获取所有的元数据：通过接口可根据元数据集 ID 获取对应元数据集下所有元 数据设定情况。 e) 分页查询字典信息：通过接口可查询当前资源库字典信息设定情况。 f) 获取资源标签：通过接口可获取当前资源库标签设定情况。 6.1.2 查询资源分类 查询资源分类接口见表1。 2 DB34/T 4085—2021 表1 查询资源分类接口 请求方式 POST URL http(s)://[ip]:[port]/zuul/repo-api/api/res/other/getClassifysById 请求参数 参数名称 类型 是否必须 appId appId String 是 描述 服务ID，明文传输，如:appId=default id = “0”，获取资源全部基础分类； data id String 是 id= “-1”，获取资源一级拓展分类； id= 拓展分类ID，获取下一级拓展分类； 成功： { 返回数据 "code": 0, 格式（id = "msg": "操作成功", “0”，获取 "data": { 资源全部基 }, 础分类；） } 略 失败： 请参照接口返回错误状态码表（见附录A）。 成功： { 返回数据 "code": 0, 格式（id= "msg": "操作成功", “-1”，获取 "data": { 资源一级拓 }, 展分类；） } 略 失败： 请参照接口返回错误状态码表（见附录A）。 成功： { 返回数据 "code": 0, 格式（id= 拓 "msg": "操作成功", 展分类ID，获 "data": { 取下一级拓 }, 展分类；） } 略 失败： 请参照接口返回错误状态码表（见附录A）。 6.1.3 分页查询元数据集 分页查询元数据集接口见表2。 3 DB34/T 4085—2021 表2 分页查询元数据集接口 请求方式 POST URL http(s)://[ip]:[port]/zuul/repo-api/api/res/other/getAllMetadataList 请求参数 参数名称 类型 是否必须 appId appId String 是 服务ID，明文传输，如:appId=default pageIndex String 是 当前页 pageSize String 是 每页显示记录数 data 描述 成功： { "code":0, 返回数据 格式 "msg":"操作成功", "data":{ 略 } } 失败： 请参照接口返回错误状态码表（见附录A）。 6.1.4 分页查询元数据 分页查询元数据接口见表3。 表3 分页查询元数据接口 请求方式 POST URL http(s)://[ip]:[port]/zuul/repo-api/api/res/other/getAllMetadatas 请求参数 参数名称 类型 是否必须 appId appId String 是 服务ID，明文传输，如:appId=default pageIndex String 是 当前页 pageSize String 是 每页显示记录数 data 成功： { "code":0, 返回数据 格式 "msg":"操作成功", "data":{ 略 } } 失败： 请参照接口返回错误状态码表（见附录A）。 6.1.5 根据元数据集 ID 获取所有的元数据 根据元数据集ID获取所有元数据接口见表4。 4 描述 DB34/T 4085—2021 表4 根据元数据集 ID 获取所有元数据接口 请求方式 POST URL http(s)://[ip]:[port]/zuul/repo-api/api/res/other/getMetadatasByDmId 请求参数 参数名称 类型 是否必须 描述 appId appId String 是 服务ID，明文传输，如:appId=default data dmId String 是 元数据集ID 成功： { "code":0, 返回数据 格式 "msg":"操作成功", "data":{ 略 } } 失败： 请参照接口返回错误状态码表（见附录A）。 6.1.6 分页查询字典信息 分页查询字典信息接口见表5。 表5 分页查询字典信息接口 请求方式 POST URL http(s)://[ip]:[port]/zuul/repo-api/api/res/other/getDictionaryDataByParentId 请求参数 参数名称 类型 是否必须 appId appId String 是 服务ID，明文传输，如:appId=default dicType String 是 字典类型:0为查询系统字典；1为查询用户字典； parentId String 否 字典父节点ID dicDataName String 否 字典名称（可模糊匹配） pageIndex String 是 当前页 pageSize String 是 每页显示记录数 data 描述 成功： { "code": 0, "msg": "操作成功", 返回数据格式 "data": { 略 } } 失败： 请参照接口返回错误状态码表（见附录A）。 6.1.7 获取资源标签 5 DB34/T 4085—2021 获取资源标签接口见表6。 表6 获取资源标签接口 请求方式 POST URL http(s)://[ip]:[port]/zuul/repo-api/api/res/other/selectLabelManagement 请求参数 参数名称 类型 是否必须 描述 appId appId String 是 服务ID，明文传输，如:appId=default data searchWord String 否 名称模糊匹配 成功： { "code":0, "msg":"操作成功", "data":{ 略 返回数据格式 } } 失败： 请参照接口返回错误状态码表（见附录A）。 6.2 资源管理接口 6.2.1 资源管理接口内容 资源管理接口包括但不限于以下类型。 a) 新增资源：通过接口可在指定资源库新增一条信息资源，并设定其相关属性。 b) 批量删除资源：通过接口可批量删除指定资源库目录或指定信息资源 ID 的资源。 c) 批量移动资源：通过接口可批量移动指定资源库目录或指定信息资源 ID 的资源。 d) 根据资源 ID 查询：通过接口可根据资源 ID 查询指定资源的相关情况。 e) 上传文件：通过接口可上传本地已有的信息资源。 f