Discover Scenes

Last Updated on : 2021-07-16 07:39:07download

Query the information about all scenes of a specified user.

API address

GET: /v1.0/iot-01/voice/users/{uid}/scenes

Request parameter

Parameter name Type IN Required Description
uid String uri true The user 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
scenes List The object collection of multiple scenes.
version String The version number.
message_id String The request identifier.

Description of scenes

Parameter name Type Description
capabilities List The collection of standard capabilities.
category String The standard category.
scene_id String The primary key of a specified scene.
scene_name String The scene name.

Description of capabilities

Parameter name Type Description
attributes List The collection of standard attributes.
commands List The collection of standard capabilities.
interface_name String The interface type.
support_query Boolean Indicates whether the information can be queried.
support_report Boolean Indicates whether the information can be reported.

Description of attributes

Parameter name Type Description
code String The standard attribute.
rang_type String The value type.
range_value Object The value range.

Request example

GET: /v1.0/iot-01/voice/users/ay1618816013155*****/scenes

Return example

{ "result": { "message_id": "f6e97d36-42a8-43e6-b5d6-1ba26aa5824b", "version": "V1.0", "scenes": [ { "capabilities": [ { "support_report": false, "interface_name": "Tuya.SmartHome.PowerstateController", "support_query": false, "attributes": [ { "code": "powerstate", "rang_type": "onOff" } ], "commands": [ "TurnOn" ] } ], "category": "Scene" }, { "capabilities": [ { "support_report": false, "interface_name": "Tuya.SmartHome.PowerstateController", "support_query": false, "attributes": [ { "code": "powerstate", "rang_type": "onOff" } ], "commands": [ "TurnOn" ] } ], "category": "Scene" }, { "capabilities": [ { "support_report": false, "interface_name": "Tuya.SmartHome.PowerstateController", "support_query": false, "attributes": [ { "code": "powerstate", "rang_type": "onOff" } ], "commands": [ "TurnOn" ] } ], "scene_id": "vgr6jYlO*****", "category": "Scene", "scene_name": "\"five light\" Switch: on" }, { "capabilities": [ { "support_report": false, "interface_name": "Tuya.SmartHome.PowerstateController", "support_query": false, "attributes": [ { "code": "powerstate", "rang_type": "onOff" } ], "commands": [ "TurnOn" ] } ], "scene_id": "a3A4Go4g****", "category": "Scene", "scene_name": "Turn on the light in the morning" } ] }, "t": 1620986480544, "success": true }

Error code

For more information, see error code.