Query Device Details

Last Updated on : 2024-06-29 01:53:14download

Based on the device ID, query the details of the specified device.

API address

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

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringpathtrueThe device ID.

Return parameter

Parameter nameTypeDescription
resultDeviceFusionVOThe list of returned data.
successBooleanIndicates whether the operation is successful. Valid values:
  • true: The operation succeeded.
  • false: The operation failed.
tLongThe timestamp.
tidStringThe link ID.

Description of result

Parameter nameTypeDescription
idStringThe device ID.
active_timeLongThe time when the specified device is activated, which is accurate to seconds.
categoryStringThe product category of the specified device.
create_timeLongThe time when the specified device is first paired, which is accurate to seconds.
update_timeLongThe time when the specified device is updated, which is accurate to seconds.
custom_nameStringThe custom name of the specified device.
iconStringThe icon of the specified device.
ipStringThe IP address of the specified device.
is_onlineBooleanIndicates whether the specified device is online.
latStringThe latitude of the specified device.
local_keyStringThe unique encrypted key of the specified device over LAN.
lonStringThe longitude of the specified device.
nameStringThe name of the specified device.
product_idStringThe product ID of the specified device.
product_nameStringThe product name of the specified device.
subBooleanIndicates whether the specified device is a sub-device.
time_zoneStringThe time zone in which the specified device is located.
uuidStringThe universally unique identifier (UUID) of the specified device.

Request example

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

Return example

{
    "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": "Robot Vacuum A001",
        "uuid": "vdevo165abcd98***",
        "active_time": 1659422574,
        "update_time": 1659422574,
        "custom_name": "Robot Vacuum in Living Room",
        "product_id": "h9sabcugftb***",
        "name": "Robot Vacuum-vdevo",
        "id": "vdevo165abcd98***",
        "is_online": true,
        "category": "cz",
        "lat": "50.3029"
    },
    "t": 1677748119016,
    "success": true
}

Error code

For more information, see error code.

Limits on API Request Frequency

For more information, see Limits on API Request Frequency.