Ebeco Open API

Ebeco tilbyr åpne API‑er som gjør det mulig å integrere våre produkter i eksterne systemer, smarthusløsninger og eiendomsplattformer. Hvilket Open API som benyttes avhenger av produktmodell og integrasjonsmetode – skybasert eller lokal direkteintegrasjon mot termostaten.

Kom i gang

Gjør følgende for å bruke vårt Open API:

1. Velg riktig nettverk og legg inn nettverkets passord på enheten
2. Last ned Ebeco Connect fra App Store eller Google Play
3. Opprett en brukerkonto i henhold til instruksjonene i appen
4. Lag din egen tjeneste eller app ved hjelp av dokumentasjonen nedenfor

Oversikt – hvilket API gjelder for hvilket produkt?

Ebecos åpne API‑er er tilpasset hver produktplattform og bruksområde.

Cloud Open API

For Wallflex 500/600 og EB‑Therm 500

Cloud Open API brukes for integrasjon av Ebecos tilkoblede produkter via Ebeco Connect og Ebecos backend. API‑et er egnet for løsninger der flere enheter administreres sentralt, og der integrasjon skjer via internett.

Brukes når du vil:

• Integrere Wallflex 500/600 eller EB‑Therm 500 i eksterne systemer
• Arbeide med skybasert styring og overvåking
• Administrere flere installasjoner eller lokasjoner sentralt

Tekniske spesifikasjoner:

• REST‑API som forventer og returnerer JSON‑data
• Autentisering via Ebeco Connect
• Kommunikasjon via Ebecos backend

En fullstendig referanse over alle metoder og parametere finnes i vår Swagger‑dokumentasjon.

Begrensninger

For å unngå misbruk av API‑et er antall forespørsler begrenset per IP‑adresse til totalt 10 forespørsler innenfor en periode på 10 sekunder og totalt 30 forespørsler innenfor en periode på 60 sekunder.

Hvis grensen for antall forespørsler overskrides, returnerer "API‑et HTTP 429 – Too Many Requests" for resten av den aktuelle perioden. Når perioden er avsluttet, begynner API‑et å svare igjen.

Local Open API (BLE)

For EB‑Therm 300

Local Open API er et lokalt åpent API for direkte kommunikasjon med EB‑Therm 300‑termostaten via Bluetooth Low Energy (BLE). Ingen internettforbindelse eller skytjeneste er nødvendig.

API‑et er beregnet for gateway‑løsninger, innebygde systemer og lokale styresystemer som trenger direkte tilgang til termostaten.

Brukes når du vil:

• Integrere EB‑Therm 300 lokalt
• Kommunisere direkte med termostaten
• Unngå avhengighet av sky eller internett

Teknisk oversikt:

• Bluetooth Low Energy (BLE)
• Kryptert kommunikasjon (PSK + AES‑GCM)
• Binær protokoll tilpasset innebygde systemer

Dokumentasjon – Last ned teknisk spesifikasjon (.md)

Bruksvilkår

Materialet som tilbys via Ebecos åpne API‑er, må ikke brukes til distribusjon av skadelig kode eller på måter som kan skade Ebecos varemerke. Vi ber også om at Ebeco oppgis som kilde.
Tilgjengelige funksjoner og kommandoer kan variere avhengig av produktmodell og firmwareversjon. Enkelte funksjoner er begrenset til Ebecos egne apper og backend.