Search for Sub-devices

Last Updated on : 2023-06-15 04:51:04

The gateway searches for sub-devices. The default searching time is 100 seconds. If no sub-device is found after a timeout period, the search failed.

API address

POST: /v1.0/iot-03/device-registration/devices/{device_id}/actions/discover

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringuritrueThe device ID.
durationIntegerqueryfalseThe duration for the gateway to search for sub-devices. Valid values: 0–3,600 seconds. Default value: 100 seconds.

Return parameter

Parameter nameTypeDescription
resultBoolean

Request example

POST: /v1.0/iot-03/device-registration/devices/xxxid/actions/discover?duration=100

Return example

{
    "result": true,
    "t": 1591872112140,
    "success": true
}

Error code

For more information, see error code.