根据 UUID 查询最新设备详情

更新时间：2026-06-23 10:13:00LLM 副本以 Markdown 格式查看下载 PDF

本文介绍根据 UUID 查询最新设备详情的 API。

接口描述

根据设备硬件唯一标识（UUID）查询该设备的基础信息。入参传入设备 UUID，服务端返回设备的云端 ID、名称、所属品类、在线状态及归属空间等信息。若 UUID 为空则参数校验失败；若设备不存在、已解绑或已删除，则返回空值（或对应业务错误码）。

接口地址

GET: /v2.0/cloud/thing/last/{uuid}

请求参数

参数名	类型	参数位置	是否必填	说明
uuid	String	path	true	设备的 UUID

返回参数

参数名	类型	说明
result	DeviceFusionVO	返回数据集
success	Boolean	操作是否成功： `true`：操作成功 `false`：操作失败
t	Long	时间戳
tid	String	链路 ID

result 说明

参数名	类型	说明
id	String	设备 ID
bind_space_id	String	绑定空间 ID
active_time	Long	设备的激活时间（时间戳秒数）
category	String	设备的产品品类
create_time	Long	设备的初次配网时间（时间戳秒数）
update_time	Long	设备的更新时间（时间戳秒数）
custom_name	String	设备的自定义名称
icon	String	设备的图标
ip	String	设备的 IP 地址
is_online	Boolean	设备的在线状态
lat	String	设备的纬度
local_key	String	设备的局域网加密后的唯一密钥
lon	String	设备的经度
name	String	设备的名称
product_id	String	设备的产品 ID
product_name	String	设备的产品名称
sub	Boolean	是否为子设备
time_zone	String	设备的时区
uuid	String	设备的 UUID

请求示例

GET: /v2.0/cloud/thing/last/vdevo165abcd98***

返回示例

{
    "tid": "bb3742c6694f11f18368e250dded724c",
    "result": {
        "sub": false,
        "create_time": 1676972970,
        "local_key": "xxxx",
        "ip": "",
        "icon": "smart/icon/bay1634643319171hln1/8dee77c5e5272511c332d1***.png",
        "lon": "",
        "time_zone": "",
        "product_name": "插座",
        "uuid": "vdevo165abcd98***",
        "active_time": 1676972970,
        "update_time": 1677206700,
        "custom_name": "测试设备1",
        "product_id": "m1rdbmka",
        "name": "插座",
        "model": "AE434",
        "id": "vdevo165abcd98***",
        "is_online": true,
        "category": "cz",
        "lat": "",
        "bind_space_id": "123456***"
    },
    "t": 1781592659165,
    "success": true
}

错误码

参考错误码。