简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

查询家庭房间设备

更新时间:2022-04-29 05:35:22下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
home_idLonguritrue家庭 ID
room_idLonguritrue房间 ID

返回参数

参数名类型说明
resultList返回参数说明

result 说明

参数名类型说明
idString设备 ID
uuidString设备唯一标识
uidString用户 ID
biz_typeInteger应用 bizType
nameString设备名称
time_zoneString时区
ipString设备 IP
local_keyString密钥
subBoolean判断是否为子设备
  • true:是
  • false:不是
modelString产品型号
create_timeLong设备初次配网时间,以 10 位时间戳表示
update_timeLong设备状态更新时间,以 10 位时间戳表示
active_timeLong设备上次配网时间,以 10 位时间戳表示
statusList设备功能状态
owner_idString设备拥有者 ID
product_idString产品 ID
product_nameString产品名
categoryString产品类别
iconString设备图标
onlineBoolean判断设备是否在线
  • true:在线
  • false:不在线
node_idString判断是否存在子设备。
  • true:存在子设备
  • false:不存在子设备

status 说明

参数名类型说明
codeString功能code
valueObject功能值

请求示例

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
}

错误码

参考 错误码