设备单指标图表数据查询

查询设备最新数据和历史数据

请求参数

Query 参数

device_id

string

设备ID

必需

data_type

enum<string>

必需

设备数据类型：遥测、属性、命令、事件

枚举值:

telemetryattributecommandevent

示例值:

telemetry

data_mode

enum<string>

必需

数据模式：最新值、历史数据（需要data_type是telemetry并且key的值是数字；需要关注：time_range，aggregate_window，aggregate_function ）

枚举值:

latesthistory

示例值:

latest

key

string

必需

数据标识符：根据data_type不同代表不同含义，遥测数据的指标名称、设备属性的键名、命令的标识符或事件的标识符

示例值:

switch

time_range

enum<string>

可选

时间范围（默认last_5m）：last_5m，last_15m，last_30m，last_1h，last_3h，last_6h，last_12h，last_24h，last_3d，last_7d，last_15d，last_30d，last_60d，last_90d，last_6m，last_1y

枚举值:

last_5mlast_15mlast_30mlast_1hlast_3hlast_6hlast_12hlast_24hlast_3dlast_7dlast_15dlast_30dlast_60dlast_90dlast_6mlast_1y

示例值:

last_5m

aggregate_window

enum<string>

可选

聚合间隔（默认no_aggregate）："no_aggregate","30s","1m","2m","5m","10m","30m","1h","3h","6h","1d","7d","1mo"

枚举值:

no_aggregate30s1m2m5m10m30m1h3h6h1d7d1mo

示例值:

no_aggregate

aggregate_function

enum<string>

可选

聚合方法（默认avg）：avg-平均数 max-最大值 mix-最小值 sum-求和 diff-最大最小的差值

枚举值:

avgmaxminsumdiff

示例值:

avg

Header 参数

x-token

string

可选

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

device_id

string

必需

data_type

string

必需

key

string

必需

aggregate_window

string

可选

aggregate_function

string

可选

time_range

string

可选

value

可选

timestamp

integer

可选

1736718976297(毫秒)

points

array [object {2}]

可选

示例

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "device_id": "af13ac2c-3a9e-5ab9-cd31-0cf01f984b3c",
    "data_type": "telemetry",
    "key": "temperature",
    "aggregate_window": "no_aggregate",
    "aggregate_function": null,
    "time_range": null,
    "value": 65.97,
    "timestamp": 1742470195000,
    "points": [
      {
        "t": 1742469775972,
        "v": 14.59
      },
      {
        "t": 1742469745970,
        "v": 40.82
      },
      {
        "t": 1742469715971,
        "v": 12.41
      },
      {
        "t": 1742469685963,
        "v": 57.03
      },
      {
        "t": 1742469655963,
        "v": 43.14
      },
      {
        "t": 1742469625961,
        "v": 79.77
      },
      {
        "t": 1742469595961,
        "v": 97.91
      },
      {
        "t": 1742469565965,
        "v": 97.52
      },
      {
        "t": 1742469535960,
        "v": 52.29
      },
      {
        "t": 1742469505959,
        "v": 13.49
      }
    ]
  }
}