云服务 API 参考行业场景垂直行业解决方案空间环境管理环境数据查询查询设备环境指标的实时数据

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

更新时间：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
}

错误码

参考错误码。

上一篇环境数据查询