Home Assistant

API'et er formet efter Home Assistants climate-entitet. Felterne hedder det samme, så en integration i vidt omfang kan sende værdierne videre uden oversættelse.

Feltoversættelse¶

Sensorens rå værdier ligger stadig under sensor og hører hjemme som selvstændige entiteter:

En bygning bliver naturligt et device, og rummene kan lægges i areas.

power er ikke en effekt i watt. Styringen åbner og lukker telestaten inden for et fast tidsvindue, og power er den andel af vinduet, ventilen står åben — 0.5 er åben halvdelen af tiden. Vinduets længde afhænger af rummets gulvtype og af opsætningen, så regn ikke med en bestemt varighed.

Ét kald pr. opdatering¶

Det ene kald giver alle rum med de aktuelle målinger. Der findes med vilje ikke et separat sensor-endpoint, netop så en pollende integration slipper for at hente rum og sensorer hver for sig.

Et interval på 30-60 sekunder er rigeligt. Temperaturen i en bolig ændrer sig langsomt, og sensorerne rapporterer ikke oftere.

Tilgængelighed¶

Bygningen bærer to felter, der kommer fra gatewayens livstegn:

available har tre tilstande, ikke to:

null er ikke det samme som nede. Det er typisk en bygning, hvor hardwaren aldrig er blevet sat op. En integration bør behandle false som unavailable, mens null snarere bør give en tydelig besked om, at der ikke er noget at forbinde til.

Har en bygning flere gateways, tæller den nyeste heartbeat — én glemt enhed trækker ikke et fungerende hus offline.

Tænd og sluk¶

Bag kulissen holdes et slukket rum på nul effekt — der findes ikke en separat afbryder. Det kan du se i svaret: manual_power bliver {"enabled": true, "power": 0}. Du kan sætte det direkte i stedet, hvis du vil have en delvis overstyring frem for helt slukket.

Sender du både hvac_mode og manual_power i samme kald, vinder hvac_mode — så resultatet ikke afhænger af rækkefølgen i JSON'en.

Nøglen¶

Opret nøglen på Min konto eller i appen under Indstillinger → API-nøgler, og kopiér den med det samme — den vises kun én gang.

Den passer direkte ind i et config flow: brugeren indsætter nøglen, og integrationen henter selv listen af bygninger med GET /v1/buildings.

Læg nøglen i integrationens konfiguration — ikke i kode. Skal den spærres igen, sker det begge steder. Se Autentificering.