查询家庭房间设备

更新时间：2023-06-15 04:52:46

本文介绍查询家庭房间设备的 API。

接口描述

用于查询家庭房间中的设备。

接口地址

GET: /v1.0/homes/{home_id}/rooms/{room_id}/devices

请求参数

参数名	类型	参数位置	是否必填	说明
home_id	Long	uri	true	家庭 ID
room_id	Long	uri	true	房间 ID

返回参数

参数名	类型	说明
result	List	返回参数说明

result 说明

参数名	类型	说明
id	String	设备 ID
uuid	String	设备唯一标识
uid	String	用户 ID
biz_type	Integer	应用 bizType
name	String	设备名称
time_zone	String	时区
ip	String	设备 IP
local_key	String	密钥
sub	Boolean	判断是否为子设备 true：是 false：不是
model	String	产品型号
create_time	Long	设备初次配网时间，以 10 位时间戳表示
update_time	Long	设备状态更新时间，以 10 位时间戳表示
active_time	Long	设备上次配网时间，以 10 位时间戳表示
status	List	设备功能状态
owner_id	String	设备拥有者 ID
product_id	String	产品 ID
product_name	String	产品名
category	String	产品类别
icon	String	设备图标
online	Boolean	判断设备是否在线 true：在线 false：不在线
node_id	String	判断是否存在子设备。 true：存在子设备 false：不存在子设备

status 说明

参数名	类型	说明
code	String	功能code
value	Object	功能值

请求示例

GET: /v1.0/homes/31****/rooms/234****/devices

{}

返回示例

{
    "result": [
        {
            "sub": false,
            "create_time": 1601276997,
            "local_key": "023b0565cafb****",
            "owner_id": "2567****",
            "biz_type": 116030,
            "ip": "",
            "icon": "smart/icon/ay1536722.png",
            "time_zone": "",
            "product_name": "wifi测试1.2",
            "uuid": "vdevo16012769974****",
            "active_time": 1601276997,
            "uid": "ay1555492511130R****",
            "update_time": 1601276997,
            "product_id": "afctjpmhjvxr****",
            "name": "wifi测试1.2-vdevo",
            "online": true,
            "id": "vdevo16012769974****",
            "category": "dj",
            "status": [
                {
                    "code": "switch_led",
                    "value": "false"
                }
            ]
        }
    ],
    "t": 1603804495501,
    "success": true
}

错误码

参考错误码。

上一篇修改房间名称

下一篇查询⽤户家庭列表