获取用户的设备列表

更新时间：2023-12-07 03:33:55下载pdf

本文介绍获取用户的设备列表的 API。

接口描述

查询用户可操作的设备列表和各设备的信息，包括设备属性和设备状态等。

接口地址

GET: /v1.0/users/{uid}/devices

请求参数

参数名	类型	参数位置	是否必填	说明
uid	String	uri	true	用户 UID
from	String	query	false	来源。 `home`：查询当前用户房屋下的设备 `share`：查询当前用户接收到的分享设备
page_no	Integer	query	false	当前页，`0` 为第一页
page_size	Integer	query	false	分页大小

返回参数

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

result 说明

参数名	类型	说明
id	String	设备 ID
uuid	String	设备唯一标识
uid	String	用户 ID
biz_type	Integer	应用业务类型标识
name	String	设备名称
time_zone	String	时区
ip	String	设备 IP
local_key	String	密钥
sub	Boolean	是否为子设备： `true`：是 `false`：不是
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`：不在线

status 说明

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

请求示例

GET: /v1.0/users/ay15***********/devices

GET /v1.0/users/ay15ay15***********/devices?page_no=0&page_size=50

返回示例

{
    "result": [
        {
            "sub": false,
            "create_time": 1540691155,
            "local_key": "11a53bdd67e4****",
            "owner_id": "357****",
            "ip": "**.62.43.**",
            "biz_type": 293964,
            "icon": "smart/product_icon/cz.png",
            "time_zone": "+08:00",
            "uuid": "27511006b4e62d4b****",
            "product_name": "Wi-Fi智能计量插座",
            "active_time": 1548584422,
            "uid": "ay1548569152777Q****",
            "update_time": 1548584559,
            "product_id": "EvolhYPyZNWYP***",
            "name": "xxx测试",
            "online": true,
            "id": "27511006b4e62d4b****",
            "category": "cz",
            "status": [
                {
                    "code": "cur_power",
                    "value": 0
                },
                {
                    "code": "cur_voltage",
                    "value": 2196
                },
                {
                    "code": "switch",
                    "value": false
                },
                {
                    "code": "countdown_1",
                    "value": 0
                },
                {
                    "code": "cur_current",
                    "value": 0
                }
            ]
        }
    ],
    "t": 1564996327422,
    "success": true
}

错误码

参考错误码。