Cloud Services API ReferenceAdvanced Device ServicesExtension APIsIR Control Hub Open ServiceInfrared Air Conditioner APIsGet Air Conditioner Status in Bulk

Get Air Conditioner Status in Bulk

Last Updated on : 2023-06-20 14:54:06

Based on the device ID, get the current status of air conditioners. Up to 100 devices can be queried at a time.

API address

GET: /v1.0/cloud/rc/infrared/ac/status/batch

Request parameter

Parameter name	Type	IN	Required	Description
device_ids	String	query	true	The list of device IDs, separated with commas (,).

Return parameter

Parameter name	Type	Description
result	List	The list of device status.
success	Boolean	Indicates whether the API is called successfully. Valid values: `true`: The API call succeeded. `false`: The API call failed.

Description of result

Parameter name	Type	Description
devId	String	The device ID.
powerOpen	Boolean	Indicates whether the specified air conditioner is powered on. Valid values: `true`: The air conditioner is powered on. `false`: The air conditioner is powered off.
mode	String	The working mode.
temp	String	The temperature.
fan	String	The wind speed level.
swing	String	The swing status.
wet	String	The humidity.

Request example

GET: /v1.0/cloud/rc/infrared/ac/status/batch?device_ids=dev1,dev2

Return example

{
    "tid": "303ea3d9dce111eda853c62a3bb695e3",
    "result": [
        {
            "devId": "dev1",
            "temp": "18",
            "mode": "0",
            "powerOpen": true,
            "fan": "0",
            "swing": "false"
        },
        {
            "devId": "dev2",
            "temp": "20",
            "mode": "0",
            "powerOpen": true,
            "fan": "0",
            "swing": "false"
        }
    ],
    "t": 1681709526090,
    "success": true
}

Error code

For more information, see error code.

Prev DocControl Air Conditioner with Single Command

Next DocInfrared Learning APIs