控制场景

更新时间：2021-07-16 07:41:18下载pdf

本文介绍控制场景的 API。

接口描述

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

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
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/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
}

错误码

参考错误码。