查询设备环境指标的统计数据

更新时间:2023-06-15 05:40:46

本文介绍查询设备环境指标的统计数据的 API。

接口描述

通过资产 ID,查询资产下设备各项环境指标近七日统计数据。

接口地址

GET: /v1.0/iot-03/assets/{asset_id}/devices/environment-statistics

请求参数

参数名 类型 参数位置 是否必填 说明
asset_id String uri true 资产 ID
last_row_key String query false 最后行号

返回参数

参数名 类型 说明
result DeviceEnvironmentStatisticsRes

result 说明

参数名 类型 说明
asset_name String 资产名称
devices List 设备列表
last_row_key String 每页最后一条数据行号
has_next Boolean 是否有下一页

devices 说明

参数名 类型 说明
device_id String 设备 ID
statistics_data List 统计数据

statistics_data 说明

参数名 类型 说明
date String 统计日期
values List 统计点列表

values 说明

参数名 类型 说明
code String 指标编码
types List 统计类型列表

types 说明

参数名 类型 说明
type String 统计类型, 如: avg, min, max
value String 统计值
unit String 统计值单位

请求示例

GET: GET /v1.0/iot-03/assets/19237****74234/devices/environment-statistics?last_row_key=ad2fsw2dw

返回示例

{ "result": { "last_row_key": "vdevo162676686854434", "devices": [ { "device_id": "6ce2041044d859508ccaxh", "statistics_data": [ { "date": "20210721", "values": [ { "types": [ { "type": "avg", "unit": "", "value": "25.54" } ], "code": "bright_value" } ] }, { "date": "20210720", "values": [ { "types": [ { "type": "avg", "unit": "", "value": "29.55" } ], "code": "bright_value" } ] }, { "date": "20210719", "values": [ { "types": [ { "type": "avg", "unit": "", "value": "55.06" } ], "code": "bright_value" } ] } ] }, { "device_id": "6c41f233a8812ba234zsza", "statistics_data": [ { "date": "20210721", "values": [ { "types": [ { "type": "avg", "unit": "", "value": "1.46" } ], "code": "bright_value" } ] }, { "date": "20210720", "values": [ { "types": [ { "type": "avg", "unit": "", "value": "26.42" } ], "code": "bright_value" } ] }, { "date": "20210719", "values": [ { "types": [ { "type": "avg", "unit": "", "value": "118.33" } ], "code": "bright_value" } ] } ] } ], "asset_name": "办公室", "has_next": false }, "t": 1626835082945, "success": true }

错误码

参考 错误码