Get the latest status of multiple devices

Last Updated on : 2024-09-10 01:49:20

Get the latest status of multiple devices by the device IDs.

API address

GET: /v1.0/iot-03/devices/status

Request parameter

Parameter name	Type	IN	Required	Description
device_ids	String	query	true	The device IDs. Multiple IDs are separated by a comma (,). Limit up to 20.

Return parameter

Parameter name	Type	Description
result	List

Description of result

Parameter name	Type	Description
id	String	Device ID
status	List	The list of device status

Description of status

Parameter name	Type	Description
code	String	Status code
value	Object	Status value

Request example

GET: /v1.0/iot-03/devices/status?device_ids=xxxid1,xxxxid2

Return example

{
    "result": [
        {
            "id": "xxxxxx",
            "status": [
                {
                    "code": "switch_led",
                    "value": true
                },
                {
                    "code": "work_mode",
                    "value": "scene_2"
                }
            ]
        }
    ],
    "t": 1591872112140,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet the status of a single device

Next DocDevice Group