查询家庭下的设备列表

更新时间:2023-11-23 06:49:47下载pdf

本文介绍查询家庭下的设备列表的 API。

接口描述

根据家庭 ID,查询家庭下的设备列表。

接口地址

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

请求参数

参数名类型参数位置是否必填说明
home_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设备初次配网时间
update_timeLong设备状态更新时间
active_timeLong设备上次配网时间
statusList设备功能状态
owner_idString设备拥有者 ID
product_idString产品 ID
product_nameString产品名
categoryString产品类别
iconString设备图标
onlineBoolean是否在线
  • true:在线
  • false:不在线
node_idString节点 ID。当 sub 取值为 true 时,本字段有值,即子设备存该值
latString纬度

status 说明

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

请求示例

GET: /v1.0/homes/3196002/devices

返回示例

{
    "tid": "cbe7c5807d3811eeaf40161d72836dc2",
    "result": [
        {
            "sub": false,
            "create_time": 1669898482,
            "local_key": "47b69****04f952",
            "owner_id": "16968315",
            "biz_type": 0,
            "ip": "",
            "icon": "smart/icon/ay1550298204274iXb1I/ce28b24ac1bf8f9b1beba4fadc37e***.png",
            "lon": "120.2961",
            "time_zone": "+08:00",
            "product_name": "手指机器人Plus",
            "uuid": "tuyaa****f514d253",
            "active_time": 1669898482,
            "uid": "ay15913****50677KZlj2",
            "update_time": 1699339271,
            "product_id": "yii****7zh",
            "name": "手指机器人Plus",
            "online": true,
            "model": "ADFB0301",
            "id": "6cf0ca9****ab76bfjntj",
            "category": "szjqr",
            "lat": "30.3663",
            "status": [
                {
                    "code": "switch",
                    "value": true
                },
                {
                    "code": "mode",
                    "value": "click"
                },
                {
                    "code": "arm_down_percent",
                    "value": 96
                }
            ]
        },
        {
            "sub": false,
            "create_time": 1669898437,
            "local_key": "bf69a****7e54779",
            "owner_id": "16****315",
            "biz_type": 0,
            "ip": "220.191.122.216",
            "icon": "smart/icon/ay1562803410690AUgvL/165491159782534db9***.png",
            "lon": "120.2655",
            "time_zone": "+08:00",
            "product_name": "mesh网关",
            "uuid": "133530a****4bfc92fc",
            "active_time": 1669898437,
            "uid": "ay1591****0677KZlj2",
            "update_time": 1699061536,
            "product_id": "nowfs****fqwzudwr",
            "name": "mesh网关",
            "online": true,
            "model": "JMWBG1",
            "id": "6c9f204****8cff47egj6w",
            "category": "wg2",
            "lat": "30.2210",
            "status": [
            ]
        }
    ],
    "t": 1699339338983,
    "success": true
}

错误码

参考 错误码