批量获取设备最新状态

更新时间:2023-12-07 03:33:48下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
device_idsStringquerytrue设备 ID ,多个 ID 以半角逗号(,)分隔,限制最多20个

返回参数

参数名类型说明
resultList

result 说明

参数名类型说明
idString设备 ID
statusList设备状态列表

status 说明

参数名类型说明
codeString状态码
valueObject状态值

请求示例

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
}

错误码

参考 错误码