Read-only podatkovni API i deep-link za aktivaciju partnera za integraciju Host Logicovih AI agenata u Vaš PMS ili platformu za upravljanje nekretninama. Ova stranica dokumentira samo ono što je danas aktivno — jasno označen odjeljak Plan razvoja pokriva ono što slijedi.
Nabavite svoj API ključ → čitajte potrošnju licenci i signale cijena → ugradite poveznicu za aktivaciju domaćina u svoje sučelje. To je cjelokupna integracijska petlja dostupna danas.
Nabavite svoj API ključ
Postanite partner. Nakon odobrenja, Host Logic kreira Vaš partnerski račun i šalje Vam jednokratnu poveznicu za otkrivanje koja sadrži Vaš hlk_ API ključ. Pohranite ga sigurno — ne može se ponovno prikazati nakon otkrivanja.
Čitajte potrošnju & signale cijena
Pozovite GET /partner-api/v1/usage za praćenje potrošnje licenci i GET /partner-api/v1/properties/{id}/pricing-signals za prikaz Marcus podataka o cijenama unutar Vaše platforme.
Ugradite poveznicu za aktivaciju
Dodajte gumb u svoje sučelje koji otvara HMAC-potpisani deep-link https://hostlogic.io/partner/{slug}/activate?token=…. Domaćin odabire proizvode, njegov Host Logic račun se dodjeljuje i Laura je spremna.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — key is valid, response contains your seat usage
# 401 Unauthorized — key missing or invalid
# 403 Forbidden — key valid but missing required scope
# 429 Too Many Requests — rate limit (120 req/min)Svi API zahtjevi zahtijevaju Bearer token u Authorization zaglavlju. Svoj API ključ dobivate nakon odobrenja partnerstva putem jednokratne poveznice za otkrivanje — ključ u čitljivom obliku nikada se ne pohranjuje na poslužitelju i ne može se ponovno prikazati.
API ključevi imaju prefiks hlk_, ograničeni su na Vaš partnerski račun i mogu se rotirati bez prekida rada. Svaki ključ nosi skup opsega (scopes) koji određuju koje endpointe smije pozivati. Prvih 12 znakova svakog ključa (prefiks ključa) pohranjeno je u čitljivom obliku radi identifikacije u zapisima — ostatak je heširan.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 zahtjeva/minuti po API ključu. Prekoračenje vraća 429 Too Many Requests.
metrics:read — uvijek dodijeljen; pokriva endpoint za potrošnju.marcus:read — dodjeljuje se kada Vaš partnerski ugovor uključuje Marcus (Revenue Manager) podatke; pokriva endpointe za nekretnine i signale cijena.
| Kod | Značenje |
|---|---|
401 | Nedostajući ili nevažeći API ključ |
403 | Ključ je važeći, ali nedostaje potreban opseg za ovaj endpoint |
404 | Resurs nije pronađen ili nije u vlasništvu Vašeg partnerskog računa |
429 | Prekoračeno ograničenje broja zahtjeva — 120 req/min |
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"curl https://api.hostlogic.io/partner-api/v1/usage \
-H "X-Enterprise-Key: hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"Sljedeći endpointi i integracijski obrasci danas su u produkciji. Sve navedeno ovdje stvarno je i pozivo s važećim API ključem.
/usage
Potrošnja licenci za Vaš partnerski račun. Opseg: metrics:read (uvijek dodijeljen). Pogledajte potpunu referencu u nastavku.
/properties
Popis nekretnina koje pripadaju Vašim sponzoriranim domaćinima. Opseg: marcus:read. Pogledajte potpunu referencu u nastavku.
/properties/{propertyId}/pricing-signals
Marcus signali cijena i nadolazeća popunjenost za sponzoriranu nekretninu. Opseg: marcus:read. Pogledajte potpunu referencu u nastavku.
Deep-link za aktivaciju partnera
HMAC-potpisani URL koji dodjeljuje sponzorirani račun domaćina. Ugrađen u Vaše sučelje kao gumb. Pogledajte potpunu referencu u nastavku.
Vraća broj aktivnih licenci autentificiranog partnera s raščlambom po domaćinu. Korisno za usklađivanje naplate ili izgradnju nadzorne ploče potrošnje unutar Vaše platforme.
metrics:read — uvijek dodijeljen svim partnerskim ključevima.
Ovaj endpoint vraća podatke samo za autentificiranog partnera. Nikada ne prihvaća partner_id parametar upita — identitet dolazi u cijelosti iz Vašeg API ključa.
Raščlamba koristi neprozirne ID-eve korisnika domaćina i brojeve licenci. E-mail adrese domaćina namjerno su izostavljene.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"{
"partner_id": 1,
"generated_at": "2026-06-01T10:30:00Z",
"active_seats": 7,
"hosts": [
{ "host_user_id": 42, "active_seats": 4 },
{ "host_user_id": 67, "active_seats": 3 }
]
}Vraća sve nekretnine koje pripadaju domaćinima koje sponzorira Vaš partnerski račun. Koristite ovo za otkrivanje koje nekretnine možete upitati za signale cijena.
marcus:read — dodjeljuje se kada Vaš partnerski ugovor uključuje podatkovni sloj Marcus Revenue Managera.
Svaki unos sadrži interni id nekretnine (potreban za endpoint signala cijena) i name nekretnine. Osobni podaci domaćina osim naziva nekretnine su izostavljeni.
curl https://api.hostlogic.io/partner-api/v1/properties \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"{
"partner_id": 1,
"generated_at": "2026-06-01T10:30:00Z",
"properties": [
{ "id": 12, "name": "Harbour View Apartment" },
{ "id": 17, "name": "Old Town Studio" }
]
}Vraća Marcus signale cijena i nadolazeću popunjenost za jednu sponzoriranu nekretninu. Koristite id vrijednosti nekretnine koje vraća GET /properties. Vraća se 404 ako nekretnina nije pronađena ili nije u vlasništvu Vašeg partnerskog računa.
marcus:read
lookback_days (cijeli broj, zadano 90) — vremenski okvir povijesti rezervacija koji se koristi za izračun signala.
Objekt signals sadrži pokazatelje cijena i statistiku rezervacija. Točan skup polja može se razvijati kako Marcus dodaje nove izvore podataka. Reprezentativni primjer u nastavku prikazuje polja dostupna pri lansiranju — sva neprepoznata polja tretirajte kao aditivna.
curl "https://api.hostlogic.io/partner-api/v1/properties/12/pricing-signals?lookback_days=90" \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"{
"property_id": 12,
"signals": {
"occupancy_today": 0.75,
"avg_lead_time_days": 18.4,
"avg_stay_nights": 3.2,
"source_mix": {
"booking.com": 0.62,
"direct": 0.38
},
"total_reservations": 87
},
"occupancy_30d": {
"2026-06-01": 0.75,
"2026-06-02": 0.80
}
}Umjesto REST poziva, domaćini koje sponzoriraju partneri uključuju se putem potpisanog deep-linka. Domaćin ga klikne, dolazi na tržnicu bez cijena gdje odabire proizvode, i njegov Host Logic račun se dodjeljuje — sponzorirano i bez potrebe za zasebnim plaćanjem.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Gdje je {slug} jedinstveni identifikator Vašeg partnerskog računa (dostavljen pri uključivanju), a token je HMAC-potpisani, kratkotrajni payload koji nosi tvrdnje o identitetu domaćina.
Tokeni se potpisuju s HMAC-SHA256 koristeći signing_secret Vašeg partnera (odvojeno od Vašeg API ključa). Format je:
<base64url-payload>.<sha256-hmac>
Payload nosi tvrdnje o identitetu domaćina, vremensku oznaku isteka na strani poslužitelja (exp) i nasumični nonce za sprječavanje ponovne upotrebe tokena.
Zadano: 1 sat. Istekli tokeni se odbijaju s jasnom pogreškom — domaćini moraju zatražiti novu poveznicu. Host Logic preporučuje generiranje poveznica na zahtjev (npr. kada domaćin klikne gumb u Vašem sučelju) umjesto njihove pohrane.
Danas se aktivacijski tokeni generiraju putem administratorskog alata od strane Host Logica na zahtjev. Samostalno izdavanje tokena od strane partnera (programsko generiranje tokena iz Vašeg vlastitog backenda) nalazi se u Planu razvoja — pogledajte u nastavku.
https://hostlogic.io/partner/previo/activate
?token=eyJjb250YWN0X2VtYWlsIjoiaG9zdEBleGFtcGxlLmNvbSIsImV4cCI6MTc1MDAwMDAwMCwibm9uY2UiOiJhYjEyY2QzNCJ9.a1b2c3d4e5f6...<!-- Simple button — opens in a new tab -->
<a href="{{ $activationUrl }}" target="_blank" class="btn">
Set up AI Receptionist →
</a>{
"contact_email": "[email protected]",
"contact_name": "Hotel Adriatic",
"previo_hotel_id": "779307",
"requested_product_ids": ["laura-receptionist"],
"exp": 1750000000,
"nonce": "ab12cd34"
}| Korak | Što se događa |
|---|---|
| 1. Token provjeren | Host Logic potvrđuje HMAC potpis i provjerava istek. Nevažeći ili istekli tokeni prikazuju jasnu stranicu pogreške. |
| 2. Tržnica | Domaćin dolazi na tržnicu proizvoda bez cijena ograničenu na Vaš partnerski ugovor. Odabire koje proizvode aktivirati. |
| 3. Račun dodijeljen | Kreira se sponzorirani Host Logic račun domaćina (ili se povezuje ako e-mail već postoji). Proizvodi se aktiviraju bez koraka plaćanja. |
| 4. Uključivanje | Domaćina se vodi kroz Laurin čarobnjak za bazu znanja (upute za prijavu, česta pitanja, ponude nadogradnji). Laura počinje odgovarati gostima čim se čarobnjak potvrdi. |
Sljedeće mogućnosti planirane su ili u razvoju. Ovdje su navedene radi transparentnosti kako biste mogli planirati svoj integracijski plan. Nijedna od njih danas nije pozivo — izgradnja prema njima sada rezultirat će pogreškama.
Samostalno izdavanje tokena od strane partnera
API endpoint ili isječak SDK-a za preuzimanje koji Vašem backendu omogućuje generiranje potpisanih aktivacijskih tokena bez uključivanja Host Logica. Danas se tokeni generiraju na zahtjev putem administratorskog alata.
Opsezi za pisanje & endpointi za izmjenu
Opsezi poput marcus:write i pierre:write te REST endpointi za registraciju nekretnina (POST /properties), aktivaciju ili deaktivaciju pojedinačnih jedinica i ažuriranje partnerskih postavki.
Webhookovi / događaji u stvarnom vremenu
Push obavijesti za dovršeno uključivanje, aktiviranu/deaktiviranu jedinicu i pragove potrošnje. Registrirajte webhook URL i primajte potpisane payloade.
Samostalni partnerski portal
Samostalni portal ograničen zastavicom za upravljanje API ključevima, pregled potrošnje licenci i konfiguraciju dopuštenih izvora ugradnje. Trenutno u privatnoj beta fazi.
Pierre endpoint za održavanje
GET /properties/{propertyId}/operational-state — stanje održavanja i operativno stanje za sponzoriranu nekretninu. Izgrađeno, ali onemogućeno značajkom (feature flag); zahtijeva pierre:read opseg. Dostupno odabranim partnerima na zahtjev.
Ugradnja iframe-a za uključivanje
Ugradite Laurin čarobnjak za konfiguraciju kao iframe u sučelje Vašeg PMS-a, s postMessage događajima za napredak koraka i dovršetak. Ovisi o lansiranju samostalnog partnerskog portala.
Hostirani MCP poslužitelj za enterprise
Hostirani MCP endpoint na mcp.hostlogic.io koji pruža pristup alatima za Claude Desktop / Cursor podacima ograničenim na partnera. Arhitektura je planirana; još nije aktivna za enterprise partnere.
Enterprise partneri imaju namjenski Slack kanal s Host Logic timom. Javite se na [email protected] kako biste razgovarali o svojim integracijskim zahtjevima i vremenskom okviru.
Recite nam o svom PMS-u, channel manageru ili softverskom proizvodu za ugostiteljstvo. Partnerske prijave pregledavamo unutar 2 radna dana te dostavljamo Vaš API ključ i namjenski kanal podrške.