设备控制

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

本文介绍设备控制的 API。

接口描述

通过指定的用户 ID、设备 ID、控制指令和指令值,进行设备控制的接口。

接口地址

POST: /v1.0/iot-01/voice/users/{uid}/devices/{device_id}/commands

请求参数

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

body 说明

参数名 类型 参数位置 是否必填 说明
interface_name String true 接口名称
command String true 指令代码
value 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*****/devices/vdevo1620380207*****/commands
{ "interface_name": "Tuya.SmartHome.PowerstateController", "command": "TurnOff", "value": "off" }

返回示例

{ "result": { "message_id": "fa84349a-1701-464a-af1f-45d5e5607032" }, "t": 1620463296244, "success": true }

错误码

参考 错误码