场景控制

更新时间:2021-07-16 07:40:36下载pdf

本文介绍场景控制的 API。

接口描述

通过用户ID、场景 ID 和控制指令进行场景控制的接口。

接口地址

POST: /v1.0/iot-01/voice/users/{uid}/scenes/{scene_id}/commands

请求参数

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

body 说明

参数名 类型 参数位置 是否必填 说明
interface_name String true 接口名称
command String true 指令代码

返回参数

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

result 说明

参数名 类型 说明
message_id String 请求标识符
version String 接口版本号

请求示例

POST: /v1.0/iot-01/voice/users/ay1618816013155*****/scenes/Wn4TxJBCHcoh****/commands
{ "scene_id": "Wn4TxJBCHcoh****", "uid": "ay1618816013155*****", "interface_name": " Tuya.SmartHome.PowerstateController", "command": "TurnOn" }

返回示例

{ "result": { "message_id": "b5e281b0-433b-44d4-ab7f-bb971e1a69fa", "version": "V1.0" }, "t": 1620987268824, "success": true }

错误码

参考 错误码