• 文档
• 有关 TSDB 数据服务 API V2.0

有关 TSDB 数据服务 API V2.0

该版本是 TSDB 数据服务 API 的旧版本。推荐使用 V2.1 版本，参见 有关 TSDB 数据服务 API V2.1。

API 列表

你可以通过下表了解可以调用 V2.0 TSDB 数据服务 API 执行哪些操作，每项操作对应的 URL，以及是否适用于 EnOS Cloud 和 EnOS Edge。

API名称	描述	适用于 EnOS Cloud	适用于 EnOS Edge
Filter Asset Latest Data	过滤查询多个设备单个测点的最新数据。支持查询的数据类型为 Numeric 和 String.	√	√
Get Asset AI Data with Aggregation Logic	获取指定设备的指定测点在某段时间内的 AI 分钟级归一化数据。	√	√
Get Asset AI Raw Data	获取指定设备的指定测点在某段时间内的 AI 原始数据。	√	√
Get Asset Current Day Electric Power	获取指定设备从本地时间0点开始到当前时间已累计的电量数据。	√	√
Get Asset DI Data	获取指定设备在某段时间内的状态（DI）数据。	√	√
Get Asset DI Data Duration	获取指定设备在一段时间内不同状态（DI）的时长统计。	√	√
Get Asset Electric Power Data	获取指定设备在某段时间内的电量数据。	√	√
Get Asset Generic Data	获取指定设备的指定测点在某段时间内通用类型的数据。	√	√
Get Asset Latest Data	获取指定设备所有测点的最新数据。	√	√
Get Asset Raw Data By Time Range	获取指定设备的指定测点在某段时间内原始数据的值（包括 AI、DI 和通用数据类型）。	√	√
Get Asset Unified Raw Data	用于查询标准数据和非标准数据的统一接口。	√	×

API 请求方法

TSDB 数据服务 API V2.0 支持 GET 和 POST 两种请求方法：

• GET 方法：请求参数包含在请求 URL 中，适用于请求参数较少的情况。

• POST 方法：请求参数以表单的形式包含在请求体（Body）中，适用于请求参数较长的情况。

SDK 示例推荐 Poseidon 版本：

<dependency>
    <groupId>com.envisioniot</groupId>
    <artifactId>apim-poseidon</artifactId>
    <version>0.1.14</version>
</dependency>

有关如何通过 EnOS SDK 调用 API 的更多信息，参见 通过 EnOS SDK 调用 EnOS API。

通用错误码

代码	错误信息	描述
400	Invalid param error	存在不合法的请求参数。
701	Data service ERROR	服务出错。
702	An error occurred when execute query in data service	查询数据服务异常。