Query Device Status

Last Updated on : 2021-07-16 07:40:22download

Query the status of a specified device.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
uid	String	uri	true	The user ID.
device_id	String	uri	true	The device ID.

Return parameter

Parameter name	Type	Description
result	Object	The returned result.
success	Boolean	Indicates whether the operation is successful. `true`: succeeded. `false`: failed.
t	Long	The returned 13-bit timestamp.
code	Integer	The response code. It is empty on success.
msg	String	The error message that is returned if the request fails. It is empty on success.

Description of result

Parameter name	Type	Description
message_id	String	The request identifier.
version	String	The version number.
status	List	The object collection of all attributes and attribute values of the device.

Description of status

Parameter name	Type	Description
attribute	String	The standard attribute.
interface_name	String	The standard interface.
value	String	The standard value.

Request example

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

Return example

{
    "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
}

Error code

For more information, see error code.