Get the list of sub-devices

Last Updated on : 2023-06-19 07:06:01

Get the list of sub-devices of a specified device.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	uri	true	Gateway device ID

Return parameter

Parameter name	Type	Description
result	List

Description of result

Parameter name	Type	Description
id	String	Device ID
name	String	Device name
online	Boolean	Online status of the device
active_time	Long	The time when the device is activated
update_time	Long	The time when the device status is updated
product_id	String	Product ID of the device
category	String	Category
node_id	String	The nodeId of the sub-device
asset_id	String	Asset ID
icon	String	Device icon

Request example

GET: /v1.0/iot-03/devices/xxxid/sub-devices

Return example

{
    "result": [
        {
            "asset_id": "******",
            "active_time": 1566973357,
            "update_time": 1566973363,
            "product_id": "tob46aoq******",
            "name": "Smoke detector",
            "online": true,
            "id": "xxxxx",
            "category": "ywbj"
        }
    ],
    "t": 1591872112140,
    "success": true
}

Error code

For more information, see error code.

Prev DocRestore Defaults

Next DocModify Frozen Status