Brzi početak

Tri koraka do puštanja u rad

Preuzmite Vaš API ključ → pročitajte korišćenje mesta i signale za cene → ugradite link za aktivaciju domaćina u Vaš UI. To je kompletan integracioni tok dostupan danas.

Step 1 Preuzmite Vaš API ključ

Postanite partner. Nakon odobrenja, Host Logic kreira Vaš partnerski nalog i šalje Vam jednokratni link za otkrivanje koji sadrži Vaš hlk_ API ključ. Čuvajte ga bezbedno — nakon otkrivanja ne može ponovo da se prikaže.

Step 2 Pročitajte korišćenje i signale za cene

Pozovite GET /partner-api/v1/usage da pratite potrošnju mesta, i GET /partner-api/v1/properties/{id}/pricing-signals da prikažete Marcus podatke o cenama unutar Vaše platforme.

Step 3 Ugradite link za aktivaciju

Dodajte dugme u Vaš UI koje otvara HMAC-potpisani deep-link https://hostlogic.io/partner/{slug}/activate?token=…. Domaćin bira proizvode, njegov Host Logic nalog se kreira, a Laura je spremna.

GET /partner-api/v1/usage Proverite da li Vaš ključ radi

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "Authorization: Bearer hlk_your_key_here" \
  -H "Accept: application/json"

# 200 OK — ključ je ispravan, odgovor sadrži Vaše korišćenje mesta
# 401 Unauthorized — ključ nedostaje ili je neispravan
# 403 Forbidden — ključ je ispravan, ali nedostaje obavezni scope
# 429 Too Many Requests — ograničenje brzine (120 zahteva/min)

Autentikacija

Autentikacija API ključem

Svi API zahtevi zahtevaju Bearer token u zaglavlju Authorization. API ključ dobijate nakon odobrenja partnera putem jednokratnog linka za otkrivanje — običan ključ se nikada ne čuva na serveru i ne može ponovo da se prikaže.

API ključevi imaju prefiks hlk_, vezani su za Vaš partnerski nalog i mogu se rotirati bez prekida rada. Svaki ključ ima skup scope-ova koji određuju koje endpoint-e može da poziva. Prvih 12 karaktera svakog ključa (prefiks ključa) čuva se u čistom tekstu radi identifikacije u logovima — ostatak je heširan.

Osnovni URL-ovi https://api.hostlogic.io/partner-api/v1

Sandbox / DEV:
https://api-dev.hostlogic.io/partner-api/v1

Ograničenje brzine

120 zahteva/minut po API ključu. Prekoračenje vraća 429 Too Many Requests.

Scope-ovi

metrics:read — uvek odobren; obuhvata endpoint za korišćenje.
marcus:read — odobren kada Vaš partnerski ugovor uključuje Marcus (Revenue Manager) podatke; obuhvata endpoint-e za objekte i pricing-signals.

Kodovi grešaka

Kod	Značenje
`401`	API ključ nedostaje ili je neispravan
`403`	Ključ je ispravan, ali nedostaje obavezni scope za ovaj endpoint
`404`	Resurs nije pronađen ili nije u vlasništvu vašeg partnerskog naloga
`429`	Prekoračen limit zahteva — 120 zahteva/min

Svaki zahtev — preporučeni zaglavlje

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Alternativno zaglavlje (za praktičnost u CLI-ju)

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "X-Enterprise-Key: hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Dostupno odmah

Aktivni endpointi i funkcionalnosti

Sledeći endpointi i obrasci integracije danas su u produkciji. Sve što je ovde navedeno zaista postoji i može se pozvati uz važeći API ključ.

GET /usage

Korišćenje mesta za vaš partnerski nalog. Opseg: metrics:read (uvek odobren). Pogledajte potpunu referencu u nastavku.

GET /properties

Prikaz objekata koji pripadaju vašim sponzorisanih domaćinima. Opseg: marcus:read. Pogledajte potpunu referencu u nastavku.

GET /properties/{propertyId}/pricing-signals

Marcus signali cena i predstojeća popunjenost za sponzorisani objekat. Opseg: marcus:read. Pogledajte potpunu referencu u nastavku.

LINK Deep-link za aktivaciju partnera

URL potpisan HMAC-om koji kreira nalog za sponzorisanog domaćina. Ugrađuje se u vaš interfejs kao dugme. Pogledajte potpunu referencu u nastavku.

Endpoint za korišćenje

GET /usage — Korišćenje mesta

Vraća broj aktivnih mesta autentifikovanog partnera, sa pregledom po domaćinu. Korisno za usklađivanje naplate ili za izradu kontrolne table za korišćenje unutar vaše platforme.

Potreban opseg

metrics:read — uvek odobren za sve partnerske ključeve.

IDOR zaštita

Ovaj endpoint vraća podatke samo za autentifikovanog partnera. Nikada ne prihvata partner_id kao query parametar — identitet dolazi isključivo iz vašeg API ključa.

Minimizacija PII podataka

Pregled koristi neprozirne ID-jeve korisnika domaćina i broj mesta. Email adrese domaćina su namerno izostavljene.

Zahtev

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Odgovor

{
  "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 }
  ]
}

Endpoint za objekte

GET /properties — Lista sponzorisanih objekata

Vraća sve objekte koji pripadaju domaćinima koje vaš partnerski nalog sponzoriše. Koristite ovo da otkrijete za koje objekte možete da tražite signale cena.

Potreban opseg

marcus:read — odobren kada vaš partnerski ugovor uključuje Marcus Revenue Manager data plane.

Vraćeni podaci

Svaki unos sadrži interni id objekta (potreban za endpoint pricing-signals) i name objekta. PII domaćina osim naziva objekta nije uključena.

Zahtev

curl https://api.hostlogic.io/partner-api/v1/properties \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Odgovor

{
  "partner_id": 1,
  "generated_at": "2026-06-01T10:30:00Z",
  "properties": [
    { "id": 12, "name": "Harbour View Apartment" },
    { "id": 17, "name": "Old Town Studio" }
  ]
}

Endpoint za signale cena

GET /properties/{propertyId}/pricing-signals

Vraća Marcus signale cena i predstojeću popunjenost za jedan sponzorisani objekat. Koristite vrednosti id objekta vraćene putem GET /properties. Vraća se 404 ako objekat nije pronađen ili nije u vlasništvu vašeg partnerskog naloga.

Potreban opseg

marcus:read

Parametar upita

lookback_days (ceo broj, podrazumevano 90) — vremenski prozor istorije rezervacija koji se koristi za izračunavanje signala.

Napomena o obliku odgovora

Objekat signals sadrži indikatore cena i statistiku rezervacija. Tačan skup polja može da se razvija kako Marcus dodaje nove izvore podataka. Reprezentativni primer ispod prikazuje polja dostupna pri lansiranju — sva neprepoznata polja tretirajte kao dodatna.

Zahtev

curl "https://api.hostlogic.io/partner-api/v1/properties/12/pricing-signals?lookback_days=90" \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Reprezentativni odgovor (polja mogu da se menjaju)

{
  "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
  }
}

Aktivacija hosta

Partnerov deep-link za aktivaciju

Umesto REST poziva, hostovi koje sponzoriše partner uključuju se putem potpisanog deep-linka. Host klikne na njega, otvara se marketplace bez cena gde bira proizvode, a njegov Host Logic nalog se provisionuje — sponzorisan i bez potrebe za zasebnim plaćanjem.

Format linka

URL obrazac https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>

Gde je {slug} jedinstveni identifikator Vašeg partnerskog naloga (dodeljen pri uključivanju), a token HMAC-potpisan, kratkotrajni payload koji sadrži tvrdnje o identitetu hosta.

Bezbednost tokena

Tokeni se potpisuju pomoću HMAC-SHA256 algoritma i Vašeg partnerskog signing_secret ključa (odvojenog od Vašeg API ključa). Format je:

<base64url-payload>.<sha256-hmac>

Payload sadrži tvrdnje o identitetu hosta, server-side vremensku oznaku isteka (exp) i nasumični nonce radi sprečavanja ponovne upotrebe tokena.

Vreme trajanja tokena

Podrazumevano: 1 sat. Istekli tokeni se odbijaju uz jasnu poruku o grešci — hostovi moraju da zatraže novi link. Host Logic preporučuje generisanje linkova po potrebi (npr. kada host klikne dugme u Vašem UI-ju), umesto njihovog čuvanja.

Danas naspram Roadmap-a

Danas Host Logic generiše aktivacione tokene putem administratorskog alata, na zahtev. Samouslužno generisanje tokena od strane partnera (programatsko generisanje tokena iz Vašeg sopstvenog backenda) nalazi se na Roadmap-u — pogledajte ispod.

Primer deep-linka

https://hostlogic.io/partner/previo/activate
  ?token=eyJjb250YWN0X2VtYWlsIjoiaG9zdEBleGFtcGxlLmNvbSIsImV4cCI6MTc1MDAwMDAwMCwibm9uY2UiOiJhYjEyY2QzNCJ9.a1b2c3d4e5f6...

Ugradnja u Vaš UI

<!-- Simple button — opens in a new tab -->
<a href="{{ $activationUrl }}" target="_blank" class="btn">
  Set up AI Receptionist →
</a>

Tvrdnje u payload-u tokena (ilustrativno)

{
  "contact_email": "[email protected]",
  "contact_name": "Hotel Adriatic",
  "previo_hotel_id": "779307",
  "requested_product_ids": ["laura-receptionist"],
  "exp": 1750000000,
  "nonce": "ab12cd34"
}

Iskustvo hosta nakon klika

Korak	Šta se dešava
1. Token verifikovan	Host Logic validira HMAC potpis i proverava istekao rok. Neispravni ili istekli tokeni prikazuju jasnu stranicu sa greškom.
2. Marketplace	Host dolazi na marketplace proizvoda bez cena, prilagođen Vašem partnerskom ugovoru. Bira koje proizvode želi da aktivira.
3. Nalog provisionovan	Kreira se sponzorisani Host Logic host nalog (ili se povezuje ako e-mail već postoji). Proizvodi se aktiviraju bez koraka plaćanja.
4. Onboarding	Host se vodi kroz Laurin wizard baze znanja (uputstva za check-in, FAQ, upsell ponude). Laura počinje da odgovara gostima čim se wizard pošalje.

Roadmap

Uskoro stiže

Sledeće mogućnosti su planirane ili su u razvoju. Ovde su navedene radi transparentnosti, kako biste mogli da planirate svoj integracioni roadmap. Nijedna od njih danas nije dostupna za pozivanje — ako sada gradite rešenje na njima, dobićete greške.

ROADMAP Samouslužno generisanje tokena od strane partnera

API endpoint ili preuzimajući SDK snippet koji omogućava Vašem backendu da generiše potpisane aktivacione tokene bez uključivanja Host Logic-a. Danas se tokeni generišu na zahtev putem administratorskog alata.

ROADMAP Write scope-ovi i mutirajući endpoint-i

Scope-ovi kao što su marcus:write i pierre:write i REST endpoint-i za registraciju objekata (POST /properties), aktivaciju ili deaktivaciju pojedinačnih jedinica i ažuriranje partnerskih podešavanja.

ROADMAP Webhook-ovi / događaji u realnom vremenu

Push obaveštenja za završeni onboarding, aktivaciju/deaktivaciju jedinice i pragove korišćenja. Registrujte webhook URL i primajte potpisane payload-e.

ROADMAP Partnerski self-service portal

Self-service portal za upravljanje API ključevima, pregled korišćenja seat-ova i podešavanje dozvoljenih embed origin-a, pod kontrolom flag-a. Trenutno u privatnoj beta fazi.

PRIVATE BETA Pierre endpoint za održavanje

GET /properties/{propertyId}/operational-state — stanje održavanja i operativno stanje za sponzorisani objekat. Napravljen je, ali je onemogućen feature flag-om; zahteva pierre:read scope. Dostupan je odabranim partnerima na zahtev.

ROADMAP Ugradnja onboarding iframe-a

Ugradite Laura čarobnjak za konfiguraciju kao iframe u vaš PMS interfejs, uz postMessage događaje za napredak kroz korake i završetak. Zavisno od pokretanja partnerskog self-service portala.

ROADMAP Hostovani MCP server za enterprise

Hostovani MCP endpoint na mcp.hostlogic.io koji obezbeđuje Claude Desktop / Cursor pristup alatima za podatke u okviru partnera. Arhitektura je planirana; još nije aktivan za enterprise partnere.

Želite rani pristup ili da date input o prioritetima na roadmap-u?

Enterprise partneri imaju namenski Slack kanal sa Host Logic timom. Javite nam se na [email protected] kako bismo razgovarali o vašim zahtevima za integraciju i vremenskom okviru.

AI infrastruktura
koja pokreće moderne hospitality platforme

Tri koraka do puštanja u rad

Autentikacija API ključem

Kodovi grešaka

Aktivni endpointi i funkcionalnosti

GET /usage — Korišćenje mesta

GET /properties — Lista sponzorisanih objekata

GET /properties/{propertyId}/pricing-signals

Partnerov deep-link za aktivaciju

Format linka

Bezbednost tokena

Iskustvo hosta nakon klika

Uskoro stiže

Želite da dovedete Host Logic agente na svoju platformu?

AI infrastrukturakoja pokreće moderne hospitality platforme

Tri koraka do puštanja u rad

Autentikacija API ključem

Kodovi grešaka

Aktivni endpointi i funkcionalnosti

GET /usage — Korišćenje mesta

GET /properties — Lista sponzorisanih objekata

GET /properties/{propertyId}/pricing-signals

Partnerov deep-link za aktivaciju

Format linka

Bezbednost tokena

Iskustvo hosta nakon klika

Uskoro stiže

Želite da dovedete Host Logic agente na svoju platformu?

AI infrastruktura
koja pokreće moderne hospitality platforme