有关 TSDB 数据服务 API V2.1¶

该版本适用于 EnOS 2.1.3 或更新版本。关于 V2.1 TSDB 数据服务 API 的完整接口列表及功能说明，参见 API 列表。

API 列表 ¶

你可以通过下表了解可以调用 V2.1 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 Last Changed Data	获取指定设备、测点的最后变更数据。	√	×
Check Dead Data	检测指定设备的测点数据是否为死数，同时返回测点的最后变更数据。	√	×
Get Asset Unified Raw Data	获取资产的标准数据和非标准数据。	√	×

V2.1 TSDB 数据服务 API 支持 POST 请求方法，其中 orgId 位于请求 URL 中，其余请求参数以 JSON 格式包含在请求 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。

代码	错误信息	描述
80400	Invalid param error	存在不正确的请求参数。
80401	Asset unauthorized	当前应用没有对设备的访问权限。请检查服务账号 SA 的权限。
80500	Internal server error	服务内部错误。