Kom i gang med API'et

Smart Gulvvarmes API giver dig læseadgang til dine bygninger og rum — og lader dig ændre indstillingerne for et rum, for eksempel den ønskede temperatur.

Alle svar er JSON, og alle tidspunkter er ISO-8601 i UTC. Temperaturer er i grader celsius.

Du skal bruge¶

En API-nøgle, som du selv opretter — enten på Min konto her på sitet eller i Smart Gulvvarme-appen under Indstillinger → API-nøgler. Det er de samme nøgler begge steder. Den er bundet til netop dine bygninger og kan ikke nå andres.

Ved oprettelsen vælger du, om nøglen kun må læse, eller også må ændre. Vælg det mindste, der løser opgaven — en nøgle med skriveadgang kan slukke for varmen.

Vigtigt

Nøglen vises kun én gang. Kopiér den med det samme og læg den et sikkert sted. Har du mistet den, opretter du bare en ny og spærrer den gamle.

Nøglen sendes med i headeren x-api-key på hver eneste forespørgsel.

Første kald¶

Start med at hente de bygninger, din nøgle har adgang til:

curl -H "x-api-key: $SG_API_KEY" \
  https://api.smart-gulvvarme.dk/v1/buildings

Svaret er en liste. Bemærk id — det skal du bruge i alle videre kald:

[
  {
    "id": "bbd508c9-42aa-4bc5-9981-a5b523d65aca",
    "name": "Elkjær Hytten",
    "location": { "lat": 56.3162, "lng": 10.3055 },
    "available": true,
    "last_seen": "2026-08-23T08:49:57.000Z",
    "weather": {
      "updated": "2026-08-23T08:36:03.437Z",
      "temperature": 16,
      "cloud_coverage": 91,
      "wind": { "direction": 293, "speed": 23.1 }
    }
  }
]

available fortæller, om hardwaren i huset melder sig. Den kan også være null, hvis ingen gateway nogensinde har rapporteret — se Home Assistant for hvordan de tre tilstande bør håndteres.

Hent rummene¶

Ét kald giver dig alle rum i bygningen — inklusive den seneste måling fra hvert rums sensor. Du skal ikke hente sensorer separat:

Feltnavnene følger Home Assistants climate-entitet, så en integration kan sende værdierne videre stort set uændret. current_temperature og current_humidity er løftet op fra sensoren; sensor beholder de rå værdier inklusive batteri og signalstyrke.

power fortæller, hvor stor en del af tiden varmen er åben. Styringen åbner og lukker telestaten inden for et fast tidsvindue, og power er den andel af vinduet, ventilen står åben: 0.5 betyder åben halvdelen af tiden, 0.03 betyder 3 %. Vinduets længde afhænger af rummets gulvtype og af systemets opsætning.

hvac_action fortæller, hvad rummet laver lige nu: heating, idle (tændt, men varmer ikke i øjeblikket) eller off.

Ændr en indstilling¶

Sæt den ønskede temperatur i et rum:

Du får det opdaterede rum tilbage. Kun de felter, du sender, bliver ændret — resten står uberørt.

Bemærk

Varmeberegningen kører igen, når du ændrer et rum. power og hvac_action kan derfor skifte kort efter, at dit kald er returneret. De kan ikke sættes direkte.

Vil du slukke for et rum, sætter du hvac_mode til off:

Hvad så nu¶

• Autentificering — nøgler, rettigheder og fejlkoder
• Eksempler — curl, JavaScript og Dart
• Home Assistant — sådan mapper felterne til en climate-entitet
• API-reference — alle endpoints og felter