Ebeco Open API
Offene Integration für Ebecos Fußbodenheizungslösungen
Ebeco stellt Open APIs bereit, die die Integration unserer Produkte in externe Systeme, Smart-Home‑Lösungen und Gebäudemanagementplattformen ermöglichen. Welches Open API verwendet wird, hängt vom jeweiligen Produktmodell und der Art der Integration ab – cloudbasiert oder lokal direkt am Thermostat.
Erste Schritte
Führen Sie die folgenden Schritte aus, um unser Open API zu verwenden:
- Wählen Sie das richtige Netzwerk aus und geben Sie das Netzwerkpasswort im Gerät ein
- Laden Sie Ebeco Connect aus dem App Store order von Google Play herunter
- Erstellen Sie ein Benutzerkonto gemäß den Anweisungen in der App
- Erstellen Sie Ihren eigenen Dienst oder Ihre eigene Anwendung mithilfe der untenstehenden Dokumentation
Übersicht – welches API gilt für welches Produkt?
Die offenen APIs von Ebeco sind an die jeweilige Produktplattform und den Anwendungsbereich angepasst.
| Produktmodell | Typ des Open API | Integrationsmethode |
|---|---|---|
| Wallflex 500/600 | Cloud Open API | Über Ebeco Connect / Backend |
| EB-Therm 500 | Cloud Open API | Über Ebeco Connect / Backend |
| EB-Therm 300 | Local Open API | Lokale BLE‑Integration direkt am Thermostat |
Cloud Open API
Für Wallflex 500/600 und EB‑Therm 500
Das Cloud Open API wird für die Integration von Ebecos vernetzten Produkten über Ebeco Connect und das Ebeco‑Backend verwendet. Das API eignet sich für Lösungen, bei denen mehrere Geräte zentral verwaltet werden und die Integration über das Internet erfolgt.
Wird verwendet, wenn Sie:
- Wallflex 500/600 oder EB‑Therm 500 in externe Systeme integrieren möchten
- Mit cloudbasierter Steuerung und Überwachung arbeiten möchten
- Mehrere Installationen oder Standorte zentral verwalten möchten
Technische Spezifikationen:
- REST‑API, das JSON‑Daten erwartet und zurückgibt
- Authentifizerung über Ebeco Connect
- Kommunikation über das Ebeco‑Backend
Eine vollständige Referenz aller Methoden und Parameter ist in unserer Swagger-dokumentation verfügbar.
Einschränkungen
Um einen Missbrauch des API zu vermeiden, ist die Anzahl der Anfragen pro IP‑Adresse auf insgesamt 10 Anfragen innerhalb von 10 Sekunden sowie auf insgesamt 30 Anfragen innerhalb von 60 Sekunden begrenzt.
Wenn die zulässige Anzahl von Anfragen überschritten wird, gibt das API für den Rest des jeweiligen Zeitraums "HTTP 429 – Too Many Requests zurück". Nach Ablauf des Zeitraums antwortet das API wieder wie gewohnt.
Local Open API (BLE)
Für EB‑Therm 300
Das Local Open API ist ein lokales, offenes API zur direkten Kommunikation mit dem EB‑Therm‑300‑Thermostat über Bluetooth Low Energy (BLE). Eine Internetverbindung oder ein Cloud‑Dienst ist nicht erforderlich.
Das API ist für Gateway‑Lösungen, Embedded‑Systeme und lokale Steuerungssysteme vorgesehen, die einen direkten Zugriff auf das Thermostat benötigen.
Wird verwendet, wenn Sie:
- EB‑Therm 300 lokal integrieren möchten
- Direkt mit dem Thermostat kommunizieren möchten
- Eine Abhängigkeit von Cloud‑Diensten oder dem Internet vermeiden möchten
Technischer Überblick:
- Bluetooth Low Energy (BLE)
- Verschlüsselte Kommunikation (PSK + AES‑GCM)
- Binäres Protokoll, angepasst für Embedded‑Systeme
Technische Spezifikation herunterladen (.md)
Nutzungsbedingungen
Das über Ebecos offene APIs bereitgestellte Material darf nicht zur Verbreitung von Schadsoftware oder in einer Weise verwendet werden, die der Marke Ebeco schaden könnte. Außerdem ist Ebeco als Quelle anzugeben.
Verfügbare Funktionen und Befehle können je nach Produktmodell und Firmware‑Version variieren. Einige Funktionen sind auf Ebecos eigene Anwendungen und das Backend beschränkt.