Contact Us
Log In

Get Device Information

Last Updated on : 2022-04-29 05:41:16download

Get the device information by the device ID.

API address

GET: /v1.1/iot-03/devices/{device_id}

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringuritrueThe device ID.

Return parameter

Parameter nameTypeDescription

Description of result

Parameter nameTypeDescription
idStringThe device ID.
gateway_idStringThe gateway ID. The value is empty for non-gateway sub-devices.
node_idStringThe node ID. The value is empty for non-gateway sub-devices.
uuidStringThe universally unique identifier (UUID) of a specified device.
categoryStringThe category of a specified product.
category_nameStringThe name of a specified category.
nameStringThe device name.
product_idStringThe product ID.
product_nameStringThe product name.
local_keyStringThe secret key.
subBooleanIndicates whether a device is a sub-device.
asset_idStringThe asset ID.
owner_idStringThe ID of a home.
ipStringThe IP address of a specified device
lonStringThe longitude of a specified device.
latStringThe latitude of a specified device.
modelStringThe product model.
time_zoneStringThe time zone where the device is located.
active_timeLongThe time when the device is activated.
update_timeLongThe time when it is updated.
create_timeLongThe time when the device is paired for the first time.
onlineBooleanThe online status of a specified device.
iconStringThe icon of a specified device.

Request example

GET: /v1.1/iot-03/devices/xxxxxx1

Return example

    "result": {
        "result": {
            "sub": false,
            "category_name": "Light Source",
            "create_time": 1567395627,
            "local_key": "8ab649951d59****",
            "owner_id": "31256829",
            "ip": "124.90.**.***",
            "icon": "smart/icon/1526276264k8q8l44swr2ennf6zx5u92j4i_0.png",
            "lon": "120.0638",
            "time_zone": "+08:00",
            "product_name": "Light",
            "uuid": "38042025cc50e325****",
            "gateway_id": "",
            "active_time": 1620299529,
            "update_time": 1635941286,
            "product_id": "ylr9R01cMWnM****",
            "name": "Light",
            "online": true,
            "model": "LE7",
            "id": "38042025cc50e325****",
            "category": "dj",
            "lat": "30.3027"
        "t": 1635941588278,
        "success": true
    "t": 1635941588278,
    "success": true

Error code

For more information, see error code.