批量获取设备信息

更新时间:2023-06-20 14:18:01下载pdf

本文介绍批量获取设备信息的 API。

接口描述

按照设备 ID 列表批量获取设备的详细信息。

接口地址

GET: /v1.0/iot-03/devices

请求参数

参数名类型参数位置是否必填说明
device_idsStringquerytrue设备 ID 列表,多个 ID 以半角逗号(,)分隔,限制最多20个

返回参数

参数名类型说明
resultBasePageRes

result 说明

参数名类型说明
has_moreBoolean是否有下一页
totalLong符合条件的数据总条数
listList数据列表

list 说明

参数名类型说明
idString设备 ID
uuidString设备 uuid
categoryString产品品类
nameString设备名称
product_idString产品 ID
product_nameString产品名称
local_keyString密钥
subBoolean是否为子设备
asset_idString资产 ID
ipString设备 IP
lonString经度
latString纬度
modelString产品型号
time_zoneString时区
active_timeLong激活时间
update_timeLong更新时间
create_timeLong初次配网时间
onlineBoolean在线状态

请求示例

GET: /v1.0/iot-03/devices?device_ids=xxxxxx1,xxxxxx2

返回示例

{
    "result": {
        "list": [
            {
                "sub": false,
                "create_time": 1575017570,
                "local_key": "11d7f7286caa****",
                "ip": "58.251.**.****",
                "asset_id": "1160****",
                "time_zone": "+08:00",
                "product_name": "WiFi智能音箱 SS190",
                "uuid": "12****",
                "active_time": 1584063323,
                "uid": "ay156531946658X****",
                "update_time": 1584939489,
                "product_id": "i9vkzktd",
                "name": "WiFi智能音箱 SS190",
                "online": false,
                "model": "SS190",
                "id": "747b2165d9449964****",
                "category": "znyxss"
            }
        ],
        "total": 1,
        "has_more": false
    },
    "t": 1591872112140,
    "success": true
}

错误码

参考 错误码