简体中文
简体中文
English
联系我们
注册
登录

场景发现

更新时间: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 }

错误码

参考 错误码