查询设备环境指标的实时数据

更新时间：2023-06-21 07:12:56下载pdf

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

接口描述

支持通过资产 ID，以分页的形式获取资产下设备各项环境指标的实时数据。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
asset_id	String	uri	true	资产 ID
last_row_key	String	query	false	每页最后一条数据设备 ID

返回参数

参数名	类型	说明
result	EnvMonitorStatusRes

result 说明

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

devices 说明

参数名	类型	说明
device_id	String	设备ID
status	List	状态列表

status 说明

参数名	类型	说明
code	String	指标编码
value	String	指标值
unit	String	指标值单位

请求示例

GET: /v1.0/iot-03/assets/12389312***/devices/environment-status

返回示例

{
    "result": {
        "last_row_key": "vdevo162676686854434",
        "devices": [
            {
                "device_id": "6ce2041044d859508ccaxh",
                "status": [
                    {
                        "code": "bright_value",
                        "unit": "",
                        "value": "34"
                    }
                ]
            },
            {
                "device_id": "vdevo162676656009566",
                "status": [
                    {
                        "code": "co2_value",
                        "unit": "ppm",
                        "value": "0"
                    },
                    {
                        "code": "temp_current",
                        "unit": "℃",
                        "value": "-400"
                    },
                    {
                        "code": "pm25_value",
                        "unit": "",
                        "value": "0"
                    },
                    {
                        "code": "voc_value",
                        "unit": "ppm",
                        "value": "0"
                    },
                    {
                        "code": "ch2o_value",
                        "unit": "",
                        "value": "0"
                    }
                ]
            },
            {
                "device_id": "vdevo162676686854434",
                "status": [
                    {
                        "code": "temp_current",
                        "unit": "℃",
                        "value": "-400"
                    }
                ]
            },
            {
                "device_id": "vdevo162676653996073",
                "status": [
                    {
                        "code": "pm25_value",
                        "unit": "",
                        "value": "0"
                    },
                    {
                        "code": "temp_current",
                        "unit": "℃",
                        "value": "-400"
                    },
                    {
                        "code": "ch2o_value",
                        "unit": "ppm",
                        "value": "0"
                    },
                    {
                        "code": "voc_value",
                        "unit": "ppm",
                        "value": "0"
                    },
                    {
                        "code": "co2_value",
                        "unit": "ppm",
                        "value": "0"
                    }
                ]
            },
            {
                "device_id": "vdevo162676656689062",
                "status": [
                    {
                        "code": "bright_value",
                        "unit": "lux",
                        "value": "0"
                    }
                ]
            },
            {
                "device_id": "6c41f233a8812ba234zsza",
                "status": [
                    {
                        "code": "bright_value",
                        "unit": "",
                        "value": "4"
                    }
                ]
            },
            {
                "device_id": "vdevo162676653274517",
                "status": [
                    {
                        "code": "ch2o_value",
                        "unit": "ppm",
                        "value": "0"
                    },
                    {
                        "code": "temp_current",
                        "unit": "ppm",
                        "value": "-400"
                    },
                    {
                        "code": "humidity_current",
                        "unit": "%",
                        "value": "0"
                    },
                    {
                        "code": "pm25_value",
                        "unit": "ppm",
                        "value": "0"
                    },
                    {
                        "code": "voc_value",
                        "unit": "ppm",
                        "value": "0"
                    },
                    {
                        "code": "co2_value",
                        "unit": "ppm",
                        "value": "0"
                    }
                ]
            }
        ],
        "asset_name": "办公室",
        "has_next": false
    },
    "t": 1626835152733,
    "success": true
}

错误码

参考错误码。

上一篇环境数据查询