场景发现

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

本文介绍场景发现的 API。

接口描述

查询用户所有场景信息的接口。

接口地址

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

请求参数

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

返回参数

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

result 说明

参数名	类型	说明
scenes	List	多个场景对象集合
version	String	接口版本号
message_id	String	请求标识符

scenes 说明

参数名	类型	说明
capabilities	List	标准能力集合
category	String	标准品类
scene_id	String	场景主键
scene_name	String	场景名称

capabilities 说明

参数名	类型	说明
attributes	List	标准属性集合
commands	List	标准能力集合
interface_name	String	接口类型
support_query	Boolean	是否支持查询
support_report	Boolean	是否支持上报

attributes 说明

参数名	类型	说明
code	String	标准属性
rang_type	String	值类型
range_value	Object	值范围

请求示例

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

返回示例

{
    "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\" 开关:开启"
            },
            {
                "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": "清晨，灯光伴你起床"
            }
        ]
    },
    "t": 1620986480544,
    "success": true
}

错误码

参考错误码。