Ebeco Open API
Avoin rajapinta Ebecon lattialämmitysratkaisujen integrointiin
Ebeco tarjoaa avoimia rajapintoja (Open API), joiden avulla tuotteemme voidaan integroida ulkoisiin järjestelmiin, älykotiratkaisuihin ja kiinteistöalustoihin. Käytettävä Open API määräytyy tuotemallin ja integraatiotavan mukaan – pilvipohjaisesti tai paikallisesti suoraan termostaattiin.
Aloittaminen
Toimi seuraavasti käyttääksesi Open APIamme:
- Valitse oikea verkko ja syötä verkon salasana laitteeseen
- Lataa Ebeco Connect App Storesta tai Google Playstä
- Luo käyttäjätili sovelluksen ohjeiden mukaisesti
- Luo oma palvelusi tai sovelluksesi alla olevan dokumentaation avulla
Yleiskatsaus – mikä API koskee mitäkin tuotetta?
Ebecon avoimet rajapinnat on sovitettu kunkin tuotteen alustaan ja käyttötarkoitukseen.
| Tuotemalli | Open API ‑tyyppi | Integraatiotapa |
|---|---|---|
| Wallflex 500/600 | Cloud Open API | Ebeco Connectin / backendin kautta |
| EB-Therm 500 | Cloud Open API | Ebeco Connectin / backendin kautta |
| EB-Therm 300 | Local Open API | Paikallinen BLE‑integraatio suoraan termostaattiin |
Cloud Open API
Wallflex 500/600- ja EB‑Therm 500 ‑tuotteille
Cloud Open API:tä käytetään Ebecon verkkoyhteydellisten tuotteiden integrointiin Ebeco Connectin ja Ebecon backend‑järjestelmän kautta. Rajapinta soveltuu ratkaisuihin, joissa useita laitteita hallitaan keskitetysti ja integraatio tapahtuu internetin kautta.
Tekniset tiedot:
- Integroida Wallflex 500/600- tai EB‑Therm 500 ‑tuotteet ulkoisiin järjestelmiin
- Työskennellä pilvipohjaisen ohjauksen ja seurannan kanssa
- Hallita useita asennuksia tai kohteita keskitetysti
Tekniska specifikationer:
- REST API, joka vastaanottaa ja palauttaa JSON‑dataa
- Autentikointi Ebeco Connectin kautta
- Kommunikointi Ebecon backendin kautta
Täydellinen viite kaikista metodeista ja parametreista löytyy Swagger-dokumentaatiostamme.
Rajoitukset
API:n väärinkäytösten estämiseksi pyyntöjen määrää rajoitetaan IP‑osoitekohtaisesti: enintään 10 pyyntöä 10 sekunnin aikana ja enintään 30 pyyntöä 60 sekunnin aikana.
Jos pyyntöjen sallittu määrä ylitetään, API palauttaa virheen "HTTP 429 – Too Many Requests" kuluvan ajanjakson loppuun asti. Ajanjakson päätyttyä API alkaa jälleen vastata pyyntöihin.
Local Open API (BLE)
EB‑Therm 300 ‑tuotteelle
Local Open API on paikallinen avoin rajapinta suoraan kommunikointiin EB‑Therm 300 ‑termostaatin kanssa Bluetooth Low Energy (BLE) ‑yhteyden kautta. Internet‑yhteyttä tai pilvipalvelua ei tarvita.
Rajapinta on tarkoitettu yhdyskäytäväratkaisuille, sulautetuille järjestelmille ja paikallisille ohjausjärjestelmille, jotka tarvitsevat suoran yhteyden termostaattiin.
Käytetään, kun haluat:
- Integroida EB‑Therm 300 ‑termostaatin paikallisesti
Kommunikoida suoraan termostaatin kanssa
Välttää riippuvuutta pilvipalveluista tai internetistä
Tekninen yhteenveto:
- Bluetooth Low Energy (BLE)
- Salattu tiedonsiirto (PSK + AES‑GCM)
- Sulautetuille järjestelmille sovitettu binääriprotokolla
Dokumentaatio – Lataa tekninen spesifikaatio (.md)
Käyttöehdot
Ebecon avoimien rajapintojen kautta tarjottua materiaalia ei saa käyttää haitallisen koodin levittämiseen tai tavoilla, jotka voivat vahingoittaa Ebecon brändiä. Pyydämme myös ilmoittamaan Ebecon lähteeksi.
Käytettävissä olevat toiminnot ja komennot voivat vaihdella tuotemallin ja laiteohjelmistoversion mukaan. Osa toiminnoista on rajoitettu Ebecon omiin sovelluksiin ja backend‑järjestelmään.