获取设备列表

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

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

接口描述

支持通过应用、产品或设备 ID 维度获取设备列表和对应设备状态信息。

接口地址

GET: /v1.0/devices

请求参数

参数名	类型	参数位置	是否必填	说明
device_ids	String	query	false	设备 ID 列表，多个 ID 通过逗号分隔
product_id	String	query	false	产品 ID
schema	String	query	false	应用标识
last_id	String	query	false	设备最后查询 ID
page_size	Integer	query	true	分页页面大小
page_no	Integer	query	true	当前页
start_time	Long	query	false	查询的起始时间，10 位时间戳
end_time	Long	query	false	查询的截止时间，10 位时间戳

返回参数

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

result 说明

参数名	类型	说明
total	Long	总数
devices	List	设备列表
last_id	String	设备最后查询 ID

请求示例

GET: /v1.0/devices?schema=testApp&page_no=1&page_size=20

返回示例

{
    "devices": [
        {
            "sub": false,
            "create_time": 1575017570,
            "local_key": "11d7f7286caa****",
            "owner_id": "1160****",
            "biz_type": 310002,
            "ip": "58.251.**.****",
            "icon": "smart/program_category_icon/znyxss.png",
            "time_zone": "+08:00",
            "product_name": "Wi-Fi智能音箱 SS190",
            "uuid": "12****",
            "active_time": 1584063323,
            "uid": "ay156531946658X****",
            "update_time": 1584939489,
            "product_id": "i9vkz***",
            "name": "Wi-Fi智能音箱 SS190",
            "online": false,
            "model": "SS190",
            "id": "747b2165d9449964****",
            "category": "znyxss",
            "status": [
                {
                    "code": "smartspeaker_vol",
                    "value": "26"
                },
                {
                    "code": "smartspeaker_mic",
                    "value": "true"
                }
            ]
        }
    ],
    "total": 1,
    "last_id": "158493****"
}

错误码

参考错误码。