August 7, 2023

                                             [by:  OyWin](<https://www.linkedin.com/in/oywin/>)

The IKEA ZigBee AirPurifier can be controlled using Home Assistant without the need to have the IKEA Home Smart HUB. In this guide, I’m using the ConBee 2 ZigBee Coordinator to integrate it into Home Assistant via the deConz software using its RESTful API.

A RESTful API (Representational State Transfer Application Programming Interface) is a type of web API that uses HTTP requests to GET, PUT, POST, and DELETE data. Home Assistant offers a dedicated service method which allows us to GET data from the deConz REST-API.

Observe that the HA documentation about REST is divided into the following 6 chapters:

Untitled

… where the first is the main docs containing all what is common for the other 5. Then each of the other 5 documents what is particular and valid only for each one.

The IKEA STARKVIND AirPurifier (ISAP) when paired using the ConBee II gateway and deConz, arrives in Home Assistant as a pair of sensors, just as seen in Phoscon:

Untitled

Although – for some reason – only one of these are listed:

Untitled

This is actually only the first of the two entities. Where is the other? Goto ‘Help’ in the Phoscon menu and select ‘API Information’ followed by Filter = Sensors, and then select STARKVIND AirPurifier and you’ll get something like this:

Pay special attention to the URL: http://192.168.1.127:6080/api/7F46E2A5B9/sensors/59

Untitled

Everything in this URL is custom. The IP address and port number is the location of the deConz Web-Port, typically set as an environment variable named DECONZ_WEB_PORT when installing deConz. The 10 digit hexadecimal number is the API-Key and the number 59 is just a sequence number generated automatically by deConz as the next free number for new devices.

It’s a good idea to use this information to test the API using an external tool, i.e. CURL or the very user friendly browser plug-in named Boomerang, or if you are more advanced - use Postman. My preference is Boomerang:

Untitled