查询家庭下的设备列表

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

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

接口描述

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

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
home_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	设备初次配网时间
update_time	Long	设备状态更新时间
active_time	Long	设备上次配网时间
status	List	设备功能状态
owner_id	String	设备拥有者 ID
product_id	String	产品 ID
product_name	String	产品名
category	String	产品类别
icon	String	设备图标
online	Boolean	是否在线 `true`：在线 `false`：不在线
node_id	String	节点 ID。当 `sub` 取值为 `true` 时，本字段有值，即子设备存该值
lat	String	纬度

status 说明

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

请求示例

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
}

错误码

参考错误码。

上一篇删除家庭

下一篇查询家庭成员列表信息