Ebeco åbent API
Åben integration til Ebecos gulvvarmeløsninger.
Ebeco tilbyder åbne API’er, der gør det muligt at integrere vores produkter i eksterne systemer, smarthjem‑løsninger og ejendomsplatforme. Hvilket Open API der anvendes, afhænger af produktmodel og integrationsmetode – cloud‑baseret eller lokal direkte integration med termostaten.
Kom i gang
Gør følgende for at bruge vores Open API:
- Vælg det korrekte netværk, og indtast netværkets adgangskode på enheden
- Download Ebeco Connect fra App Store eller Google Play
- Opret en brugerkonto ved at følge instruktionerne i appen
- Opret din egen tjeneste eller applikation ved hjælp af nedenstående dokumentation
Oversigt – hvilket API gælder for hvilket produkt?
Ebecos åbne API’er er tilpasset den enkelte produktplatform og anvendelse.
| Produktmodel | Type Open API | Integrationsmetode |
|---|---|---|
| Wallflex 500/600 | Cloud Open API | Via Ebeco Connect / backend |
| EB-Therm 500 | Cloud Open API | Via Ebeco Connect / backend |
| EB-Therm 300 | Local Open API | Lokal BLE‑integration direkte til termostaten |
Cloud Open API
Til Wallflex 500/600 og EB‑Therm 500
Cloud Open API anvendes til integration af Ebecos opkoblede produkter via Ebeco Connect og Ebecos backend. API’et er velegnet til løsninger, hvor flere enheder administreres centralt, og hvor integrationen sker via internettet.
Anvendes, når du vil:
- Integrere Wallflex 500/600 eller EB‑Therm 500 i eksterne systemer
Arbejde med cloud‑baseret styring og overvågning
Administrere flere installationer eller lokationer centralt
Tekniske specifikationer:
- REST‑API, som forventer og returnerer JSON‑data
- Autentificering via Ebeco Connect
- Kommunikation via Ebecos backend
En komplet reference over alle metoder og parametre findes i vores Swagger-dokumentation.
Begrænsninger
For at undgå misbrug af API’et er antallet af forespørgsler begrænset pr. IP‑adresse til i alt 10 forespørgsler inden for en periode på 10 sekunder og i alt 30 forespørgsler inden for en periode på 60 sekunder.
Hvis grænsen for antal forespørgsler overskrides, returnerer API’et "HTTP 429 – Too Many Requests" i resten af den aktuelle periode. Når perioden er afsluttet, begynder API’et igen at svare på forespørgsler.
Local Open API (BLE)
Til EB‑Therm 300
Local Open API er et lokalt åbent API til direkte kommunikation med EB‑Therm 300‑termostaten via Bluetooth Low Energy (BLE). Der kræves ingen internetforbindelse eller cloud‑tjeneste.
API’et er beregnet til gateway‑løsninger, indlejrede systemer og lokale styresystemer, der har behov for direkte adgang til termostaten.
Anvendes, når du vil:
- Integrere EB‑Therm 300 lokalt
Kommunikere direkte med termostaten
Undgå afhængighed af cloud eller internet
Teknisk overblik:
- Bluetooth Low Energy (BLE)
- Krypteret kommunikation (PSK + AES‑GCM)
- Binær protokol tilpasset indlejrede systemer
Dokumentation – Download teknisk specifikation (.md)
Brugsvilkår
Materialet, der stilles til rådighed via Ebecos åbne API’er, må ikke anvendes til distribution af skadelig kode eller på måder, der kan skade Ebecos brand. Vi beder også om, at Ebeco angives som kilde.
Tilgængelige funktioner og kommandoer kan variere afhængigt af produktmodel og firmwareversion. Nogle funktioner er begrænset til Ebecos egne applikationer og backend.