查询单个设备详情

更新时间:2024-06-29 01:52:06下载pdf

本文介绍查询单个设备详情的 API。

接口描述

根据设备 ID,查询单个设备详情。

接口地址

GET: /v2.0/cloud/thing/{device_id}

请求参数

参数名类型参数位置是否必填说明
device_idStringpathtrue设备 ID。

返回参数

参数名类型说明
resultDeviceFusionVO返回数据集。
successBoolean操作是否成功。
  • true:操作成功。
  • false:操作失败。
tLong时间戳。
tidString链路 ID。

result 说明

参数名类型说明
idString设备 ID。
active_timeLong设备的激活时间(时间戳秒数)。
categoryString设备的产品品类。
create_timeLong设备的初次配网时间(时间戳秒数)。
update_timeLong设备的更新时间(时间戳秒数)。
custom_nameString设备的自定义名称。
iconString设备的图标。
ipString设备的 IP 地址。
is_onlineBoolean设备的在线状态。
latString设备的纬度。
local_keyString设备的局域网加密后的唯一密钥。
lonString设备的经度。
nameString设备的名称。
product_idString设备的产品 ID。
product_nameString设备的产品名称。
subBoolean是否为子设备。
time_zoneString设备的时区。
uuidString设备的 UUID。

请求示例

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

返回示例

{
    "tid": "cdd94127b8d911edb9d75a827c79edfd",
    "result": {
        "sub": false,
        "create_time": 1659422574,
        "local_key": "06abcd1e5fc4***",
        "ip": "100.90.34.***",
        "icon": "smart/icon/baydffaa6539efg/a6cdd065abcde3bfb689152eda***.png",
        "lon": "20.0641",
        "time_zone": "+8.0",
        "product_name": "扫地机A001",
        "uuid": "vdevo165abcd98***",
        "active_time": 1659422574,
        "update_time": 1659422574,
        "custom_name": "客厅扫地机",
        "product_id": "h9sabcugftb***",
        "name": "扫地机-vdevo",
        "id": "vdevo165abcd98***",
        "is_online": true,
        "category": "cz",
        "lat": "50.3029"
    },
    "t": 1677748119016,
    "success": true
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制