Ebeco Open API
Öppen integration för Ebecos golvvärmelösningar
Ebeco erbjuder Open API:er som gör det möjligt att integrera våra produkter i externa system, smarta hem lösningar och fastighetsplattformar. Vilket Open API som används beror på produktmodell och integrationssätt – molnbaserat eller lokalt direkt mot termostaten.
Kom igång
Gör följande för att använda vårt Open API:
- Välj rätt nätverk och skriv in nätverkets lösenord i enheten
- Hämta Ebeco Connect från App Store eller Google Play
- Skapa ett användarkonto enligt anvisningarna i appen
- Skapa din egen tjänst eller app med hjälp av nedanstående dokumentation
Översikt – vilket API gäller för vilken produkt?
Ebecos öppna API:er är anpassade efter respektive produktplattform och användningsområde.
| Produktmodell | Typ av Open API | Integrationssätt |
|---|---|---|
| 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 direkt mot termostat |
Cloud Open API
För Wallflex 500/600 och EB-Therm 500
Cloud Open API används för integration av Ebecos uppkopplade produkter via Ebeco Connect och Ebecos backend. API:t lämpar sig för lösningar där flera enheter hanteras centralt och där integration sker via internet.
Används när du vill:
- Integrera Wallflex 500/600 eller EB-Therm 500 i externa system
- Arbeta med molnbaserad styrning och övervakning
- Hantera flera installationer eller platser centralt
Tekniska specifikationer:
- REST-API som förväntar sig och returnerar JSON-data.
- Autentisering via Ebeco Connect
- Kommunikation via Ebecos backend
En fullständig referens över alla metoder och parametrar finns i vår Swagger-dokumentation.
Begränsningar
För att undvika missbruk av API:et begränsas antalet förfrågningar på IP-adressnivå med totalt 10 förfrågningar inom en period på 10 sekunder och totalt 30 förfrågningar inom en period på 60 sekunder.
Om antalet förfrågningar överskrids returnerar API:et "HTTP 429 För många förfrågningar" under återstoden av den aktuella perioden. När perioden är slut börjar API:et att svara igen.
Local Open API (BLE)
För EB Therm 300
Local Open API är ett lokalt öppet API för direkt kommunikation med EB Therm 300 termostaten via Bluetooth Low Energy (BLE). Ingen internetuppkoppling eller molntjänst krävs.
API:t är avsett för gateway-lösningar, inbyggda system och lokala styrsystem som behöver direkt åtkomst till termostaten.
Används när du vill:
- Integrera EB-Therm 300 lokalt
- Kommunicera direkt med termostaten
- Undvika beroende av moln eller internet
Tekniskt i korthet:
- Bluetooth Low Energy (BLE)
- Krypterad kommunikation (PSK + AES GCM)
- Binärt protokoll anpassat för embedded system
Dokumentation – Ladda ner teknisk specifikation (.md)
Användningsvillkor
Materialet som tillhandahålls via Ebecos öppna API får inte användas för distribution av skadlig kod eller på sätt som kan skada Ebecos varumärke. Vi vill också att du uppger Ebeco som källa.
Tillgängliga funktioner och kommandon kan variera beroende på produktmodell och firmwareversion. Vissa funktioner är begränsade till Ebecos egna appar och backend.