设备状态查询

更新时间：2021-07-16 07:39:14下载pdf

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

接口描述

为用户提供指定设备状态查询的接口。

接口地址

GET: /v1.0/iot-01/voice/users/{uid}/devices/{device_id}/status

请求参数

参数名	类型	参数位置	是否必填	说明
uid	String	uri	true	用户 ID
device_id	String	uri	true	设备 ID

返回参数

参数名	类型	说明
result	Object	返回结果
success	Boolean	判断请求是否成功。 true：成功，false：失败
t	Long	返回时间 13 位时间戳
code	Integer	响应码，成功时不显示
msg	String	请求失败的信息，成功时不显示

result 说明

参数名	类型	说明
message_id	String	请求标识符
version	String	接口版本号
status	List	设备的所有属性和属性值的对象集合

status 说明

参数名	类型	说明
attribute	String	标准属性
interface_name	String	标准接口
value	String	标准值

请求示例

GET: /v1.0/iot-01/voice/users/ay1618816013155*****/devices/vdevo1620380207*****/status

返回示例

{
    "result": {
        "message_id": "2ed98134-8058-480a-846b-d252b48c924d",
        "version": "V1.0",
        "online": true,
        "status": [
            {
                "interface_name": "Tuya.SmartHome.PowerstateController",
                "attribute": "powerstate",
                "value": "on"
            },
            {
                "interface_name": "Tuya.SmartHome.ColorTemperatureController",
                "attribute": "colorTemperature",
                "value": "20"
            },
            {
                "interface_name": "Tuya.SmartHome.ColorController",
                "attribute": "color",
                "value": "{\"h\":85,\"s\":63,\"v\":200}"
            },
            {
                "interface_name": "Tuya.SmartHome.BrightnessController",
                "attribute": "brightness",
                "value": "200"
            },
            {
                "interface_name": "Tuya.SmartHome.LightModeController",
                "attribute": "lightMode",
                "value": "colour"
            }
        ]
    },
    "t": 1620983974720,
    "success": true
}

错误码

参考错误码。