Query Device Details in Bulk

Last Updated on : 2024-06-29 01:28:38download

Based on a list of device IDs, query the details of multiple devices in bulk.

API address

GET: /v2.0/cloud/thing/batch

Request parameter

Parameter nameTypeINRequiredDescription
device_idsStringquerytrueThe list of up to 20 device IDs, separated by commas.

Return parameter

Parameter nameTypeDescription
resultListThe 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/batch?device_ids=vdevo165942257398***

Return example

{
    "tid": "a8bcb54fb8e411eda71e169efc83a172",
    "result": [
        {
            "sub": false,
            "create_time": 1659422574,
            "local_key": "06f4adf1e5fc4***",
            "ip": "124.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": "h9soglkuugftb***",
            "name": "Robot Vacuum-vdevo",
            "id": "vdevo165abcd98***",
            "is_online": true,
            "category": "cz",
            "lat": "50.3029"
        }
    ],
    "t": 1677752774750,
    "success": true
}

Error code

For more information, see error code.

Limits on API Request Frequency

For more information, see Limits on API Request Frequency.