ICS 01.040.03 A 12 贵 DB52 州 省 地 方 标 准 DB52/T 1541.4—2021 政务数据平台 第 4 部分：接口规范 Government data platform ——Part4：Interface specification 2021 - 05 - 17 发布 贵州省市场监督管理局 2021 - 09 - 01 实施 发 布 DB52/T 1541.4—2021 目  次 前  言............................................................................................................................................................. II 1 范围................................................................................................................................................................. 1 2 规范性引用文件............................................................................................................................................. 1 3 术语和定义..................................................................................................................................................... 1 4 缩略语............................................................................................................................................................. 2 5 基本要求......................................................................................................................................................... 2 6 接口组成......................................................................................................................................................... 2 7 接口要求......................................................................................................................................................... 3 8 接口安全......................................................................................................................................................... 9 Schema 示例................................................................... 10 附录 A （资料性） 认证授权服务接口 JSON 附录 B （资料性） 组织新增接口 JSON Schema 示例........................................................................... 11 附录 C （资料性） 用户新增接口 JSON Schema 示例........................................................................... 12 附录 D （资料性） 数据资源目录接口的接口信息 JSON Schema 示例............................................... 13 附录 E （资料性） 数据资源目录接口信息描述对象参数表................................................................. 15 附录 F （资料性） 数据资源目录接口的目录信息 JSON Schema 描述示例....................................... 16 附录 G （资料性） 数据资源目录描述对象参数表................................................................................. 18 附录 H （资料性） 政务数据平台接口返回 JSON 附录 I （资料性） 政务数据平台接口返回参数表................................................................................. 21 Schema 示例........................................................... 19 I DB52/T 1541.4—2021 前 言 本文件按照GB/T 1.1-2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起 草。 本文件是DB52/T 1541的第4部分。DB52/T 1541已经发布一下部分： ——第2部分：数据归集规范； ——第3部分：数据存储规范； ——第4部分：接口规范； ——第6部分：面向全网搜索应用的数据处理规范。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本文件由贵州省大数据发展管理局提出并归口。 本文件起草单位：贵州省机械电子产品质量检验检测院、贵州中软云上数据技术服务有限公司、贵 州省信息中心、贵州省量子信息和大数据应用技术研究院。 本文件主要起草人：朱小洪、宿睿智、刘彦嘉、王嘉卉、徐凯琳、田野、秦晓东、邵建平、 潘伟杰、韩朱旸、冯丹妮、尚志刚、杨昶、李怡然、吴明娅、石睿、曾映菊、唐昶、张洋、姚茂峰、 陆莹、孙瑾。 II DB52/T 1541.4—2021 政务数据平台 第 4 部分：接口规范 1 范围 本文件规定了政务数据平台数据接口的术语和定义、缩略语、基本要求、接口组成、接口要求和接 口安全。 本文件适用于政务数据平台接口的设计和应用。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 接口 interface 基于应用程序的服务能力封装成接口，并通过API网关开放给客户端调用。 3.2 数据 data 对事实、概念或指令的一种形式化表示，适用于以人工或自动方式进行通信、解释或处理。 [来源：DB52/T 1239.1-2017，3.1] 3.3 政务数据资源目录 directory of government data resources 通过对政务数据资源依据规范的元数据描述，按照一定的分类方法进行排序和编码的一组信息,用 以描述各个政务数据资源的特征，以便于对政务数据资源的检索、定位与获取。 3.4 政务数据提供方 government data provider 基于统一数据共享交换平台，利用各种技术向其他政务部门、事业单位、企业或公众提供政务数据 的实体。 1 DB52/T 1541.4—2021 3.5 访问令牌 access token 访问控制操作主体的系统对象。 4 缩略语 下列缩略语适用于本文件。 API：应用程序编程接口（Application Programming Interface） HTTP：超文本传输协议（Hyper Text Transfer Protocol） HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over SecureSocket Layer） JSON：轻量级的数据交换格式（Javascript Object Notation） REST：一种网络应用程序的设计风格和开发方式（Repersentational State Transfer） 5 基本要求 5.1 5.2 5.3 5.4 6 应采用 HTTP/HTTPS 作为传输协议。 应采用 JSON 作为消息的封装格式。 应提供服务请求成功、失败等各种情况的接口返回状态码。 应支持跨语言、跨操作系统调用。 接口组成 政务数据平台接口主要包括：认证授权服务接口、组织接口、用户接口、数据资源目录接口。政务 数据平台接口组成见图1。 图1 2 政务数据平台接口组成图 DB52/T 1541.4—2021 7 接口要求 7.1 认证授权服务接口 接口描述：政务数据提供方接入政务数据平台应调用认证授权服务接口。通过平台认证授权服务接 口进行身份验证，验证成功后接口返回的授权访问令牌，政务数据提供方操作政务数据平台接口应携带 访问令牌，进行正常会话交互。 接口地址：/api/auth_service。 接口类型：post。 请求参数：认证授权服务接口请求参数见表1。 请求示例：见附录A。 返回参数：见附录I 表I.1。 返回示例：见附录H。 表1 7.2 认证授权服务接口请求参数表 参数名称 类型 是否必填 说明 access_key string 是 政务数据平台分配给政务数据提供方的唯一标识 access_secret string 是 政务数据平台分