查询设备能力状态

更新时间：2022-11-11 03:43:48

本文介绍查询设备能力状态的 API。

接口描述

查询指定设备的所有能力。也可以根据 capability_code 和 channels 做精准筛选。

接口地址

GET: /v1.0/iot-03/devices/{device_id}/capabilities

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID。
capability_code	String	query	false	能力标识 code。
channels	String	query	false	通道列表，作用于多路产品，比如排插。

返回参数

参数名	类型	说明
result	Object	返回结果。结构为 `Map`，`key` 为能力 code，value 为能力的状态值集合。例如：{ "switch":[ { "channel":"1", "value":false } ]}

请求示例

GET: /v1.0/iot-03/devices/64***dz/capabilities?capability_code=switch

返回示例

{
    "result": {
        "countdown": [//能力code
            {
                "channel": "9",
                "value": 0
            }
        ],
        "relay_status": [//能力code
            {
                "channel": "38",
                "value": "power_off"
            }
        ],
        "switch": [//能力code
            {
                "channel": "1",
                "value": false
            }
        ]
    },
    "success": true,
    "t": 1668069255415,
    "tid": "75c83d6b60d211ed8b2566906d2287eb"
}

错误码

参考错误码。