批量获取设备信息

更新时间：2023-06-20 15:18:08下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_ids	String	query	true	设备 ID 列表，多个 ID 以半角逗号（,）分隔，限制最多20个

返回参数

参数名	类型	说明
result	BasePageRes

result 说明

参数名	类型	说明
has_more	Boolean	是否有下一页
total	Long	符合条件的数据总条数
list	List	数据列表

list 说明

参数名	类型	说明
id	String	设备 ID
uuid	String	设备 uuid
category	String	产品品类
name	String	设备名称
product_id	String	产品 ID
product_name	String	产品名称
local_key	String	密钥
sub	Boolean	是否为子设备
asset_id	String	资产 ID
ip	String	设备 IP
lon	String	经度
lat	String	纬度
model	String	产品型号
time_zone	String	时区
active_time	Long	激活时间
update_time	Long	更新时间
create_time	Long	初次配网时间
online	Boolean	在线状态

请求示例

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
}

错误码

参考错误码。