DB35/T 1893-2020 生态环境大数据管理平台接口规范

DB35/T 1893-2020 生态环境大数据管理平台接口规范
仅供个人学习
反馈
标准编号:
文件类型:.pdf
资源大小:1012.7K
标准类别:环保标准
资源ID:39257
免费资源

标准规范下载简介

DB35/T 1893-2020 生态环境大数据管理平台接口规范简介:

DB35/T 1893-2020 是一个地方标准,全称为《生态环境大数据管理平台接口规范》,它是中国福建省生态环境厅发布的一项技术标准。这个标准主要规定了生态环境大数据管理平台的接口设计、数据交换、服务调用、数据安全等相关要求,旨在推动生态环境大数据的标准化管理和应用。

接口规范简介如下:

1. 定义:该规范明确了生态环境大数据管理平台与外部系统、其他平台以及内部模块之间的接口设计,包括数据接口、服务接口等,确保数据的准确、高效和安全传输。

2. 数据格式:规定了数据的统一格式和内容,如数据的元数据描述、数据的结构化程度、数据的版本控制等,以提高数据的互操作性和可理解性。

3. 服务接口:明确了平台对外提供的服务接口类型,如RESTful API、消息队列接口等,以及调用这些接口的协议、参数和返回值的要求。

4. 安全控制:强调了数据安全的重要性,包括数据加密、身份验证、访问控制等措施,以保护生态环境数据的隐私和完整性。

5. 更新与维护:规定了接口规范的维护和更新机制,以适应生态环境数据管理的不断发展和变化。

总的来说,DB35/T 1893-2020 是生态环境大数据管理的重要技术支撑,对于促进生态环境数据的共享、整合和分析,提升生态环境管理效率和决策支持能力具有重要意义。

DB35/T 1893-2020 生态环境大数据管理平台接口规范部分内容预览:

宿略语适应于本文件。 应用程序编程接口(ApplicationProgramming

DB35/T 18932020

平台接口遵循RESTfulAPI规范GB∕T 23851-2009 道路除冰融雪剂,数据接口分类架构如图1所示:

接口描述基于如下基本格式: ebService: :=[] [

][] 各字段的含义如表1所示。HTTP请求的返回结果包含两部分:一部分为HTTP消息的状态 itusCode),表示响应的状态:另一部分为HTTP请求的消息体,消息体默认采用.JSON格式进行封装

DB35/T18932020

所有接口定义格式说明如下: a)接口名:接口的名称; b)说明:对接口内容的描述; c)调用格式:调用Web服务时的语法格式: d)语义:对调用格式的解释; e)调用结果:Web服务调用结果,包括成功状态和失败状态的下的响应信息, 如无特殊说明,所有Web服务接 TTP请求头

5.3 HTTP 状态码

常用的HTTP状态码表示及含义见表3,未列举状态码的名称及含义参考HTTP协议的定义。

DB35/T 18932020

6.1.1创建传感器数据

接口名:tsTable 说明:创建传感器数据。 调用格式:POST/tsTable 语义: 创建传感器数据。附加流指定该传感器数据所涉及的相关信息,包括但不限 于:名称、标识(ID)、传感器标识(传感器ID)、一个或多个传感器的元数据信息 等,支持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为201。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

6.1.2修改传感器数据

接口名:tsTable 说明:更新传感器数据,主要修改基本信息及相关属性。 调用格式:PUT/tsTable/(ID) 语义: 更新指定ID的传感器数据的基本信息、属性信息等。附加流指定需要更新的 传感器数据,支持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为201。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

6.1.3查询传感器数据

接口名:tsTable 说明:按条件查询指定的传感器数据。 调用格式:GET/tsTable/(ID)?select=(columns) 语义: 获取满足查询条件的传感器数据。指定ID,则查询指定传感器数据;未指定 ID,则查询所有传感器数据。查询所有记录时,支持输入需要返回的列名,查询结果可指定每 页数量、可指定页、可排序。 调用结果: 成功状态:

DB35/T18932020

返回的HTTP状态码为201,查询结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

6. 1.4 添加传感器

接口名:tsTable 说明:向指定传感器数据添加新的传感器相关信息。 调用格式:PUT/tsTable/addfield/(ID) 语义: 向指定的传感器数据增加传感器相关信息。附加流指定需要添加新的传感器,支 持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为201。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

接口名:tsTable 说明:修改指定传感器数据中的传感器的相关信息。 调用格式:PUT/tsTable/【ID)/fields/(传感器ID) 语义: 修改指定传感器数据中指定传感器ID的相关信息。附加流指定需要修改的传感 器,支持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为200。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

口名:tsTable 说明:删除指定传感器数据中的某个传感器的相关信息。 周用格式:DELETE/tsTable/(ID)/fields/【传感器ID) 语义: 当传感器数据中某个传感器失效或者不需要时,可以删除指定传感器的相关信息。 调用结果: 成功状态: 返回的HTTP状态码为200。 失败状态:

DB35/T 18932020

返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

6.2传感器数据实时接入接口

6.2.1Web服务接

6.2.2消息队列服务接口

6. 2. 3Java 编程接口

6.2.3.1生成数据记录接口

接口名:GenRecord 说明:将数据转化成平台能够识别的传感器数据记录。 提供方法见表4:

DB35/T18932020

6.2.3.2SDK配置接

接口名:Config 说明:设置SDK客户端的配置参数信息。 方法:voidput(StringkeyObjectvalue) 参数如表5所示:

6.3传感器数据批量导入接口

DB35/T 18932020

DB35/T 18932020

6.3.2新建导入任务

接口名:workflows 说明:创建新导入任务。 调用格式:POST/workfloWs 语义: 新建批量导入任务。附加流指定导入任务相关的信息,包括但不限于要导入的文件标 识等,支持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为201,生成任务ID,结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

6.3.3上传传感器数据文件

6.3.4获取导入任务列

接口名:workflows 说明:获取正在执行的和已经执行完成的批量导入任务列表,支持分页。 息服务平台 调用格式:GET/workflows 语义: 获取正在执行的和已经执行完成的批量导入任务列表。 调用结果: 成功状态: 返回的HTTP状态码为200,查询结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

6.3.5获取任务详情

DB35/T18932020

接口名:workflows 说明:查看批量导入任务相关的详情。 调用格式:GET/workflows/【任务ID} 语义: 根据任务ID查看导入任务的相关信息,包括任务报告。 调用结果: 成功状态: 返回HTTP状态码200,返回结果采用JSON封装,包含导入任务相关信息。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具 状态码参见5.3。

.3.6获取单个任务状态

接口名:workflows 说明:获取批量导入任务的执行状态和进度。 调用格式:GET/workflows/status/(任务ID) 语义: 根据任务ID查询某个任务状态。 调用结果: 成功状态: 返回HTTP状态码201,返回结果采用JSON封装,任务状态信息。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。

6.4传感器数据查询接口

DB35/T 18932020

DB35/T 18932020

6. 4. 2数据行查询

6.4.4数据聚合查询

DB35/T18932020

7文本/图像/视频类数据接口

7.1.1 创建对象类型

7.1.2修改对象类型

2019年全国一建《市政》通关蓝宝书7.1.3删除对象类型

DB35/T18932020

7.1.4查询对象类型

7.2上传文本/图像/视频类数据文件

7.3.1创建对象数据

DB35/T 1806-2018标准下载DB35/T18932020

©版权声明
相关文章