批量获取设备最新状态

更新时间：2023-06-15 04:49:00

本文介绍批量获取设备最新状态的 API。

接口描述

按照设备 ID，批量获取设备的最新状态。

接口地址

GET: /v1.0/iot-03/devices/status

请求参数

参数名	类型	参数位置	是否必填	说明
device_ids	String	query	true	设备 ID ，多个 ID 以半角逗号（,）分隔，限制最多20个

返回参数

参数名	类型	说明
result	List

result 说明

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

status 说明

参数名	类型	说明
code	String	状态码
value	Object	状态值

请求示例

GET: /v1.0/iot-03/devices/status?device_ids=xxxid1,xxxxid2

返回示例

{
    "result": [
        {
            "id": "xxxxxx",
            "status": [
                {
                    "code": "switch_led",
                    "value": true
                },
                {
                    "code": "work_mode",
                    "value": "scene_2"
                }
            ]
        }
    ],
    "t": 1591872112140,
    "success": true
}

错误码

参考错误码。