Dokumentation

Smart Gulvvarmes API giver adgang til dine bygninger og rum: aktuelle temperaturer, luftfugtighed og varmeforbrug — og mulighed for at ændre den ønskede temperatur i et rum.

Det er tænkt til dig, der vil bygge en integration: en visning i dit eget system, en kobling til Home Assistant, eller et script der skruer op og ned efter din egen logik.

Kom hurtigt i gang¶

Du skal bruge en API-nøgle. Den opretter du selv på Min konto eller i appen under Indstillinger → API-nøgler — den er bundet til dine egne bygninger og vises kun én gang, så kopiér den med det samme.

Find rundt¶

Kom i gang Første kald, hvordan du finder dine bygninger og rum, og hvordan du ændrer en indstilling.

Autentificering Hvordan nøglen bruges, hvilke rettigheder der findes, og hvad de enkelte fejlkoder betyder.

Eksempler Færdige kodestumper i curl, JavaScript og Dart.

Home Assistant Hvordan felterne oversættes til en climate-entitet, og hvad du skal håndtere selv.

API-reference Den fulde tekniske reference: alle endpoints, felter og skemaer. Genereres direkte fra API'ets egen OpenAPI-spec, så den er altid i takt med virkeligheden.

Godt at vide¶

• Alle svar er JSON. Tidspunkter er ISO-8601 i UTC, og temperaturer er i celsius.
• Felterne følger Home Assistants climate-entitet — current_temperature, `target_temperature`, `hvac_mode` og så videre — så en integration slipper for at oversætte.
• Et kald til /rooms giver dig alle rum i bygningen med den seneste sensormåling indlejret. Du skal ikke hente sensorer separat.
• Et poll-interval på 30-60 sekunder er rigeligt. Temperaturen i en bolig ændrer sig langsomt, og sensorerne rapporterer ikke oftere.
• Specen kan hentes direkte på [`/v1/openapi.yaml`](https://api.smart-gulvvarme.dk/v1/openapi.yaml) og bruges til at generere en klient i dit eget sprog.