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

获取设备列表

更新时间:2022-08-08 02:37:51下载pdf

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

接口描述

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

接口地址

GET: /v1.0/devices

请求参数

参数名类型参数位置是否必填说明
device_idsStringqueryfalse设备 ID 列表,多个 ID 通过逗号分隔
product_idStringqueryfalse产品 ID
schemaStringqueryfalse应用标识
last_idStringqueryfalse设备最后查询 ID
page_sizeIntegerquerytrue分页页面大小
page_noIntegerquerytrue当前页
start_timeLongqueryfalse查询的起始时间,10 位时间戳
end_timeLongqueryfalse查询的截止时间,10 位时间戳

返回参数

参数名类型说明
resultBaseDeviceInfoRes返回结果

result 说明

参数名类型说明
totalLong总数
devicesList设备列表
last_idString设备最后查询 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****"
}

错误码

参考 错误码