About TSDB Data Service API V2.0¶

This is an older version of the API. For the latest version, see V2.1.

API List¶

You can see what operations can be used via these APIs, the URL corresponding to each operation, and whether it is applicable to EnOS Cloud and EnOS Edge in the following table.

API Name	Description	EnOS Cloud	EnOS Edge
Filter Asset Latest Data	Filter and query the latest data of a single measurement point for multiple devices.	√	√
Get Asset AI Data with Aggregation Logic	Get the aggregated data of a specified measurement point of a specified device within a certain period.	√	√
Get Asset AI Raw Data	Get the original AI data of a specified measurement point of a specified device within a certain period.	√	√
Get Asset Current Day Electric Power	Get the accumulated power consumption/production data of a specified device from 00:00 (local time) to current time.	√	√
Get Asset DI Data	Get the status (DI) data of a specified device within a certain period.	√	√
Get Asset DI Data Duration	Get the duration of different status (DI) data of a specified device within a certain period.	√	√
Get Asset Electric Power Data	Get the power consumption/production data of a specified device within a certain period.	√	√
Get Asset Generic Data	Get the generic data of a specified measurement point of a specified device within a certain period.	√	√
Get Asset Latest Data	Get the latest data of all measurement points of a specified device.	√	√
Get Asset Raw Data By Time Range	Get the original data of a specified measurement point of a specified device within a certain period (including AI, DI, and Generic data types).	√	√
Get Asset Unified Raw Data	Query Standard Data and Non-Standard Data.	√	x

Request Method¶

TSDB Data Service supports both the GET and POST methods:

GET: The request parameters are included in the request URL, which can be used for requests with less parameters.
POST: The request parameters are included in the request body, which can be used for requests with long parameters (e.g., when querying data of multiple assets).

Recommend Poseidon version:

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

For more information on how to invoke EnOS APIs using EnOS SDKs, see Invoking EnOS APIs Using EnOS SDKs。

Common Error Codes¶

Code	Error Information	Description
400	Invalid param error	Parameters or parameter values are not valid. For details, refer to the error messages.
701	Sata service ERROR	An exception occurs with the data service.
702	An error occurred when execute query in data service.	Data query failed due to error of the data service. Please try again later.