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

更新时间：2023-06-21 07:13:02下载pdf

本文介绍查询设备环境指标的统计数据的 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
}

错误码

参考错误码。

上一篇查询设备环境指标的告警数据

下一篇查询资产环境指标的实时数据