CRUD rezervacija
Dohvati, kreiraj, ažuriraj i briši rezervacije programatski. Svaka promjena u vanjskom sustavu može se sinkronizirati u realnom vremenu bez ručne intervencije.
Developer API
REST API koji se uklapa u tvoj postojeći stack
Dokumentiran, verzioniran i podržan — integracija u sat vremena, ne tjednima.
Za koga je Hometipsx API?
Hometipsx API namijenjen je developerima i tehničkim timovima koji žele programatski pristup podacima o nekretninama, rezervacijama i gostima. Tipični korisnici su: property management kompanije koje imaju vlastiti CRM i žele sinkronizirati podatke, softverske kuće koje grade vertikalna rješenja za turizam, te iznajmljivači s internim IT kapacitetom koji automatiziraju vlastite procese. API je RESTful, vraća JSON, autentificira se putem Bearer tokena i dostupan je u v1 (stabilnoj) i v2 (beta) verziji. Rate limit za standardni plan iznosi 1.000 zahtjeva na sat, a za enterprise plan nema tvrdog limita.
Što možeš raditi s API-jem
Čitanje, pisanje i webhook notifikacije za sve ključne resurse.
Webhook notifikacije
Pretplati se na evente poput nove rezervacije, check-in potvrde ili plaćanja. Hometipsx šalje POST zahtjev na tvoj endpoint u roku od dvije sekunde od eventa.
Upravljanje nekretninama
Čitaj i ažuriraj podatke o nekretninama, dostupnosti i cijenama. Dinamičko određivanje cijena iz eksternog alata sada je moguće bez ulaska u sučelje.
Profili gostiju
Pristupaj podacima o gostima u skladu s GDPR pravilima. Svi podaci enkriptirani su u prijenosu i pohrani; pristup je moguć samo s validnim API ključem s odgovarajućim scope-om.
Dokumentacija i podrška za integraciju
Svaki endpoint dokumentiran je u Swagger/OpenAPI 3.0 formatu s primjerima zahtjeva i odgovora u cURL, JavaScript i Python obliku. Sandbox okruženje dostupno je besplatno svim registriranim korisnicima — testiraj bez rizika na realističnim dummy podacima. Ako nailazite na poteškoće, naš developer support tim odgovara unutar jednog radnog dana putem ticketing sustava ili izravnog Slack kanala za Enterprise klijente. Migracija s konkurentskih API-ja obično traje između četiri i osam sati za iskusnog developera, a nudimo onboarding poziv kao dio svakog plaćenog plana.
Česta pitanja o API integraciji
Koja autentifikacijska metoda se koristi?
Koristimo Bearer token autentifikaciju. API ključ generiraš u dashboardu i dodaješ ga kao Authorization header u svaki zahtjev. Ključevi se mogu rotirati bez prekida servisa.
Postoji li sandbox za testiranje?
Da — sandbox okruženje dostupno je svim registriranim korisnicima besplatno. Sandbox sadrži realistične dummy podatke za 10 nekretnina i 50 rezervacija kako bi testovi bili što bliži produkciji.
Što se dogodi ako prijeđem rate limit?
API vraća HTTP 429 s Retry-After headerom koji pokazuje koliko sekundi treba pričekati. Svaki plaćeni plan ima mogućnost privremenog povećanja limita uz najavu na support.
Je li API u skladu s GDPR-om?
Da. Svi podaci obrađuju se u EU podatkovnim centrima (Frankfurt). Pristup osobnim podacima gostiju zahtijeva eksplicitan scope pri generiranju API ključa i bilježi se u audit logu.
Spreman za integraciju? Dokumentacija te čeka.
Registriraj se i odmah dobij pristup sandbox okruženju i svim API endpoint opisima.