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

设备状态查询

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

本文介绍设备状态查询的 API。

接口描述

为用户提供指定设备状态查询的接口。

接口地址

GET: /v1.0/iot-01/voice/users/{uid}/devices/{device_id}/status

请求参数

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

返回参数

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

result 说明

参数名 类型 说明
message_id String 请求标识符
version String 接口版本号
status List 设备的所有属性和属性值的对象集合

status 说明

参数名 类型 说明
attribute String 标准属性
interface_name String 标准接口
value String 标准值

请求示例

GET: /v1.0/iot-01/voice/users/ay1618816013155*****/devices/vdevo1620380207*****/status

返回示例

{ "result": { "message_id": "2ed98134-8058-480a-846b-d252b48c924d", "version": "V1.0", "online": true, "status": [ { "interface_name": "Tuya.SmartHome.PowerstateController", "attribute": "powerstate", "value": "on" }, { "interface_name": "Tuya.SmartHome.ColorTemperatureController", "attribute": "colorTemperature", "value": "20" }, { "interface_name": "Tuya.SmartHome.ColorController", "attribute": "color", "value": "{\"h\":85,\"s\":63,\"v\":200}" }, { "interface_name": "Tuya.SmartHome.BrightnessController", "attribute": "brightness", "value": "200" }, { "interface_name": "Tuya.SmartHome.LightModeController", "attribute": "lightMode", "value": "colour" } ] }, "t": 1620983974720, "success": true }

错误码

参考 错误码