Proizvod
API koji razumije dom — ne samo uređaj
Homegardenq platforma spaja senzorske podatke, semantički kontekst i analitički sloj u jedan konzistentan sučelje.
Što točno dobivate kada pozovete naš API?
Svaki REST poziv vraća JSON strukturu s tri sloja: raw_readings (izmjerene vrijednosti u SI jedinicama), derived_metrics (izvedene veličine kao što su evapotranspiracija ili indeks udobnosti prostora) i event_flags (automatski detektirani događaji poput skoka vlage ili iznenadnog pada temperature). Svi odgovori uključuju ISO 8601 timestamp i device_id koji omogućuje deterministički replay podataka za retroaktivno testiranje vaših algoritama. Webhookovi se konfiguriraju unutar nadzorne ploče bez ikakvog kôda.
Ključne mogućnosti platforme
Svaka funkcionalnost dizajnirana je da smanji trenje u razvojnom procesu, ne da ga povećava.
REST i WebSocket API
Polling i push modeli dostupni su za isti skup endpointa. WebSocket kanal podržava filtriranje po device_id i tipu senzora, pa primate samo podatke koji su vam relevantni bez opterećivanja klijentske strane.
Interaktivna dokumentacija
Swagger UI dostupan je na docs.homegardenq.digital. Svaki endpoint možete isprobati izravno u pregledniku koristeći vaš API ključ iz sandboxa. Changelog se objavljuje uz svaki release, a deprecated endpointi ostaju aktivni minimum 12 mjeseci.
Historijski podaci do 5 godina
Na Pro i Enterprise planovima pohrana historijskih podataka seže do 5 godina unazad. Bulk export u CSV ili Parquet formatu dostupan je na zahtjev, a incrementalni exporti automatiziraju se putem scheduled webhookova.
Alerting bez dodatnih alata
Definirajte threshold pravila u nadzornoj ploči i primajte obavijesti putem emaila, Slacka ili HTTP POST-a na vaš endpoint. Prosječno kašnjenje alarma od detekcije do isporuke iznosi manje od 4 sekunde.
OAuth 2.0 i API ključevi
Podržavamo oba autentifikacijska modela. OAuth 2.0 s PKCE preporučujemo za korisničke aplikacije; API ključevi s IP whitelistingom prikladni su za server-to-server integracije u kontroliranom okruženju.
„Dokumentacija je bila odlučujući faktor. Imali smo funkcionalni prototip u srijedu ujutro, a do petka popodneva prva verzija bila je u produkciji na našoj platformi za upravljanje staklenicima. Nije nam trebao nijedan poziv s tehničkom podrškom.”
Ana Perić, Lead Engineer, GreenFlow Systems
Česta pitanja o proizvodu
Koji protokoli senzora su podržani?
Trenutno podržavamo Zigbee 3.0, Z-Wave, MQTT i HTTP REST senzore. Modbus TCP je u beta fazi i dostupan na zahtjev za Enterprise klijente. Bluetooth Low Energy planira se za Q3 2025.
Postoji li ograničenje broja uređaja po accountu?
Sandbox plan uključuje do 10 uređaja. Start plan pokriva do 100 uređaja, Pro plan do 1.000, a Enterprise plan nema gornje granice. Uređaji se mogu dodavati i uklanjati u bilo kojem trenutku bez gubitka historije.
Kako funkcionira verzioniranje API-ja?
Koristimo URL verzioniranje (/v1/, /v2/). Svaka nova glavna verzija objavljuje se s minimalno 6 mjeseci paralelnog rada s prethodnom. Breakinge changeve uvijek najavljujemo u changeloogu minimalno 90 dana unaprijed.
Mogu li testirati API bez kreditne kartice?
Da. Sandbox plan je potpuno besplatan i ne zahtijeva plaćanje ni unos kartice. Registracija traje manje od dvije minute. Sandbox uključuje sve endpointe s ograničenjem od 5.000 poziva mjesečno i 10 uređaja.
Kôd govori glasnije od marketinga — isprobajte sandbox odmah
Registracija bez kreditne kartice. Sandbox pristup aktivan je unutar 60 sekundi od potvrde emaila.
Otvorite besplatni account