Read-only dátové API a deep-link na aktiváciu partnera na integráciu AI agentov Host Logic do vášho PMS alebo property management platformy. Táto stránka dokumentuje iba to, čo je dnes dostupné — jasne označená sekcia Roadmap pokrýva to, čo príde ďalej.
Získajte API kľúč → sledujte využitie miest a cenové signály → vložte aktivačný odkaz hosta do svojho UI. Toto je celý integračný proces dostupný dnes.
Získajte svoj API kľúč
Staňte sa partnerom. Po schválení Host Logic vytvorí váš partnerský účet a pošle vám jednorazový odkaz na zobrazenie, ktorý obsahuje váš API kľúč hlk_. Uložte ho bezpečne — po zobrazení sa už nedá znova zobraziť.
Čítajte využitie & cenové signály
Volajte GET /partner-api/v1/usage na sledovanie spotreby miest a GET /partner-api/v1/properties/{id}/pricing-signals na zobrazenie cenových údajov Marcus vo vašej platforme.
Vložte aktivačný odkaz
Pridajte do svojho UI tlačidlo, ktoré otvorí HMAC podpísaný deep-link https://hostlogic.io/partner/{slug}/activate?token=…. Host si vyberie produkty, jeho účet Host Logic sa zriadi a Laura je pripravená.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — kľúč je platný, odpoveď obsahuje využitie vašich miest
# 401 Unauthorized — kľúč chýba alebo je neplatný
# 403 Forbidden — kľúč je platný, ale chýba požadovaný scope
# 429 Too Many Requests — limit požiadaviek (120 req/min)Všetky API požiadavky vyžadujú Bearer token v hlavičke Authorization. API kľúč dostanete po schválení partnerstva cez jednorazový odkaz na zobrazenie — samotný kľúč sa na serveri neukladá a nedá sa znova zobraziť.
API kľúče majú prefix hlk_, sú viazané na váš partnerský účet a možno ich rotovať bez výpadku. Každý kľúč obsahuje sadu scopeov, ktoré určujú, na ktoré endpointy sa môže volať. Prvých 12 znakov každého kľúča (prefix kľúča) sa ukladá v otvorenom texte na identifikáciu v logoch — zvyšok je hashovaný.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 požiadaviek za minútu na API kľúč. Pri prekročení sa vráti 429 Too Many Requests.
metrics:read — vždy udelený; pokrýva endpoint využitia.marcus:read — udelený, keď vaša partnerská zmluva zahŕňa údaje Marcus (Revenue Manager); pokrýva endpointy properties a pricing-signals.
| Kód | Význam |
|---|---|
401 | Chýbajúci alebo neplatný API kľúč |
403 | Kľúč je platný, ale chýba požadovaný scope pre tento endpoint |
404 | Zdroj sa nenašiel alebo nie je vo vlastníctve vášho partnerského účtu |
429 | Prekročený limit požiadaviek — 120 pož./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"Nasledujúce endpointy a integračné vzory sú dnes v produkcii. Všetko uvedené tu je reálne a volateľné s platným API kľúčom.
/usage
Využitie miest pre váš partnerský účet. Scope: metrics:read (vždy udelené). Pozrite si úplnú referenciu nižšie.
/properties
Zoznam nehnuteľností patriacich vašim sponzorovaným hostiteľom. Scope: marcus:read. Pozrite si úplnú referenciu nižšie.
/properties/{propertyId}/pricing-signals
Cenové signály Marcus a nadchádzajúca obsadenosť pre sponzorovanú nehnuteľnosť. Scope: marcus:read. Pozrite si úplnú referenciu nižšie.
Deep-link na aktiváciu partnera
URL podpísaná HMAC, ktorá zriadi účet sponzorovaného hostiteľa. Vložená vo vašom rozhraní ako tlačidlo. Pozrite si úplnú referenciu nižšie.
Vracia počet aktívnych miest autentifikovaného partnera s rozpisom podľa jednotlivých hostiteľov. Užitočné na zosúladenie fakturácie alebo na vytvorenie dashboardu využitia vo vašej platforme.
metrics:read — vždy udelené všetkým partnerským kľúčom.
Tento endpoint vracia údaje iba pre autentifikovaného partnera. Nikdy neprijíma query parameter partner_id — identita pochádza výhradne z vášho API kľúča.
Rozpis používa nepriehľadné ID používateľov hostiteľov a počty miest. E-maily hostiteľov sú zámerne vynechané.
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 }
]
}Vracia všetky nehnuteľnosti patriace hostiteľom, ktorých váš partnerský účet sponzoruje. Použite to na zistenie, pre ktoré nehnuteľnosti môžete dopytovať cenové signály.
marcus:read — udelené, keď vaša partnerská zmluva zahŕňa dátovú vrstvu Marcus Revenue Manager.
Každá položka obsahuje interné id nehnuteľnosti (potrebné pre endpoint pricing-signals) a name nehnuteľnosti. PII hostiteľa nad rámec názvu nehnuteľnosti je vylúčené.
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" }
]
}Vracia cenové signály Marcus a nadchádzajúcu obsadenosť pre jednu sponzorovanú nehnuteľnosť. Použite hodnoty id nehnuteľností vrátené z GET /properties. Ak sa nehnuteľnosť nenájde alebo nie je vo vlastníctve vášho partnerského účtu, vráti sa 404.
marcus:read
lookback_days (celé číslo, predvolene 90) — okno histórie rezervácií použité na výpočet signálov.
Objekt signals obsahuje cenové indikátory a štatistiky rezervácií. Presná sada polí sa môže vyvíjať, keď Marcus pridáva nové zdroje dát. Ukážkový príklad nižšie zobrazuje polia dostupné pri spustení — všetky nerozpoznané polia považujte za doplnkové.
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
}
}Namiesto REST volania sa hostia sponzorovaní partnerom onboardujú cez podpísaný deep-link. Hosť naň klikne, otvorí sa mu marketplace bez cien, kde si vyberie produkty, a jeho účet Host Logic sa následne zriadi — sponzorovaný a bez potreby samostatnej platby.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Kde {slug} je jedinečný identifikátor vášho partnerského účtu (poskytnutý pri onboardingu) a token je HMAC-podpísaný, krátkodobo platný payload s claims o identite hosťa.
Tokeny sú podpisované pomocou HMAC-SHA256 a vášho partnerského signing_secret (odlišného od API kľúča). Formát je:
<base64url-payload>.<sha256-hmac>
Payload obsahuje claims o identite hosťa, serverový čas vypršania platnosti (exp) a náhodný nonce na zabránenie opätovnému použitiu tokenu.
Predvolene: 1 hodina. Expirované tokeny sa odmietnu s jasnou chybovou hláškou — hostia si musia vyžiadať nový odkaz. Host Logic odporúča generovať odkazy podľa potreby (napr. keď hosť klikne na tlačidlo vo vašom rozhraní) namiesto ich ukladania.
Dnes sa aktivačné tokeny generujú cez administrátorský nástroj na požiadanie od Host Logic. Samoobslužné generovanie tokenov partnerom (programové generovanie tokenov z vášho vlastného backendu) je na Roadmape — pozrite nižšie.
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"
}| Krok | Čo sa stane |
|---|---|
| 1. Token overený | Host Logic overí HMAC podpis a skontroluje platnosť. Neplatné alebo expirované tokeny zobrazia jasnú chybovú stránku. |
| 2. Marketplace | Hosť sa dostane do marketplace produktov bez cien, ktorý je priradený k vašej partnerskej zmluve. Vyberie si, ktoré produkty chce aktivovať. |
| 3. Účet zriadený | Vytvorí sa sponzorovaný hostiteľský účet Host Logic (alebo sa prepojí, ak e-mail už existuje). Produkty sa aktivujú bez kroku platby. |
| 4. Onboarding | Hosť prejde sprievodcom znalostnej bázy od Laury (pokyny k check-inu, FAQ, ponuky upsellov). Laura začne odpovedať hosťom hneď po odoslaní sprievodcu. |
Nasledujúce funkcie sú plánované alebo vo vývoji. Uvádzame ich tu pre transparentnosť, aby ste si mohli naplánovať integračnú roadmapu. Žiadna z nich dnes nie je dostupná na volanie — ak by ste na nich teraz stavali, skončí to chybami.
Samoobslužné generovanie tokenov pre partnerov
API endpoint alebo stiahnuteľný SDK snippet, ktorý umožní vášmu backendu generovať podpísané aktivačné tokeny bez zapojenia Host Logic. Dnes sa tokeny generujú na požiadanie cez administrátorský nástroj.
Write scopes & mutujúce endpointy
Scopes ako marcus:write a pierre:write a REST endpointy na registráciu objektov (POST /properties), aktiváciu alebo deaktiváciu jednotlivých jednotiek a aktualizáciu partnerských nastavení.
Webhooky / udalosti v reálnom čase
Push notifikácie pre dokončený onboarding, aktiváciu/deaktiváciu jednotiek a prahové hodnoty používania. Zaregistrujte webhook URL a prijímajte podpísané payloady.
Samoobslužný partnerský portál
Samoobslužný portál chránený príznakom, určený na správu API kľúčov, prehľad využitia miest a konfiguráciu povolených embed originov. Momentálne v súkromnej bete.
Údržbový endpoint pre Pierre
GET /properties/{propertyId}/operational-state — stav údržby a prevádzkový stav pre sponzorovaný objekt. Je vytvorený, ale vypnutý cez feature flag; vyžaduje scope pierre:read. Dostupný vybraným partnerom na požiadanie.
Vloženie onboarding iframe
Vložte konfiguračný sprievodca Laura ako iframe do rozhrania vášho PMS, s udalosťami postMessage pre priebeh krokov a dokončenie. Závisí od spustenia partnerského self-service portálu.
Hostovaný MCP server pre enterprise
Hostovaný MCP endpoint na mcp.hostlogic.io poskytujúci prístup k nástrojom Claude Desktop / Cursor nad dátami v rozsahu partnera. Architektúra je naplánovaná; pre enterprise partnerov zatiaľ nie je v prevádzke.
Enterprise partneri majú vyhradený Slack kanál s tímom Host Logic. Ozvite sa na [email protected] a preberieme vaše integračné požiadavky a časový plán.
Povedzte nám o vašom PMS, channel manageri alebo produkte pre hospitality softvér. Žiadosti partnerov posudzujeme do 2 pracovných dní a poskytneme vám API kľúč aj vyhradený podporný kanál.