Tik skaitymui skirta duomenų API ir partnerio aktyvavimo gilusis saitas, skirti integruoti Host Logic DI agentus į Jūsų PMS arba turto valdymo platformą. Šiame puslapyje dokumentuojama tik tai, kas šiandien jau veikia — aiškiai pažymėtas Roadmap skyrius apima tai, kas bus toliau.
Gaukite savo API raktą → peržiūrėkite vietų naudojimą ir kainodaros signalus → įterpkite šeimininko aktyvavimo nuorodą į savo UI. Tai yra visa šiandien prieinama integracijos eiga.
Gaukite savo API raktą
Tapkite partneriu. Patvirtinus Host Logic sukuria Jūsų partnerio paskyrą ir atsiunčia vienkartinę atskleidimo nuorodą su Jūsų hlk_ API raktu. Saugiai jį išsaugokite — po atskleidimo jis nebegalės būti parodytas dar kartą.
Skaitykite naudojimo ir kainodaros signalus
Kreipkitės į GET /partner-api/v1/usage, kad stebėtumėte vietų sunaudojimą, ir į GET /partner-api/v1/properties/{id}/pricing-signals, kad savo platformoje matytumėte Marcus kainodaros duomenis.
Įterpkite aktyvavimo nuorodą
Pridėkite savo UI mygtuką, kuris atidaro HMAC pasirašytą gilųjį saitą https://hostlogic.io/partner/{slug}/activate?token=…. Šeimininkas pasirenka produktus, jo Host Logic paskyra sukonfigūruojama, o Laura yra pasirengusi.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — raktas galiojantis, atsakyme pateikiamas Jūsų vietų naudojimas
# 401 Unauthorized — rakto nėra arba jis neteisingas
# 403 Forbidden — raktas galiojantis, bet trūksta reikiamos apimties
# 429 Too Many Requests — užklausų limitas (120 req/min)Visoms API užklausoms Authorization antraštėje reikalingas Bearer žetonas. API raktą gausite po partnerio patvirtinimo per vienkartinę atskleidimo nuorodą — paprastas raktas niekada nesaugomas serverio pusėje ir negali būti parodytas dar kartą.
API raktai prasideda hlk_, yra priskirti Jūsų partnerio paskyrai ir gali būti keičiami nenutraukiant veikimo. Kiekvienas raktas turi nustatytą apimčių rinkinį, kuris valdo, kuriuos galinius taškus jis gali kviesti. Pirmi 12 kiekvieno rakto simbolių (rakto prefiksas) žurnaluose saugomi paprastu tekstu identifikavimui — likusi dalis yra maišoma.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 užklausų per minutę vienam API raktui. Viršijus grąžinama 429 Too Many Requests.
metrics:read — visada suteikiama; apima naudojimo galinį tašką.marcus:read — suteikiama, kai Jūsų partnerio sutartyje yra Marcus (Revenue Manager) duomenys; apima properties ir pricing-signals galinius taškus.
| Kodas | Reikšmė |
|---|---|
401 | Trūksta API rakto arba jis neteisingas |
403 | Raktas galiojantis, bet šiam galiniam taškui trūksta reikiamos apimties |
404 | Išteklius nerastas arba nepriklauso Jūsų partnerio paskyrai |
429 | Viršytas užklausų limitas — 120 užklausų/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"Toliau nurodyti galiniai taškai ir integracijos modeliai šiuo metu veikia gamybinėje aplinkoje. Viskas, kas čia išvardyta, yra realu ir gali būti iškviesta su galiojančiu API raktu.
/usage
Jūsų partnerio paskyros vietų naudojimas. Sritis: metrics:read (visada suteikiama). Žr. visą nuorodą žemiau.
/properties
Jūsų remiamiems šeimininkams priklausančių objektų sąrašas. Sritis: marcus:read. Žr. visą nuorodą žemiau.
/properties/{propertyId}/pricing-signals
Marcus kainodaros signalai ir artėjantis užimtumas remiamam objektui. Sritis: marcus:read. Žr. visą nuorodą žemiau.
Partnerio aktyvavimo gilioji nuoroda
HMAC pasirašytas URL, kuriuo sukuriama remiamo šeimininko paskyra. Įterpiamas į Jūsų sąsają kaip mygtukas. Žr. visą nuorodą žemiau.
Grąžina autentifikuoto partnerio aktyvių vietų skaičių su suskirstymu pagal kiekvieną šeimininką. Naudinga suderinant sąskaitas arba kuriant naudojimo suvestinę Jūsų platformoje.
metrics:read — visada suteikiama visiems partnerio raktams.
Šis galinis taškas grąžina duomenis tik autentifikuotam partneriui. Jis niekada nepriima partner_id užklausos parametro — tapatybė nustatoma tik pagal Jūsų API raktą.
Suskirstyme naudojami neidentifikuojami šeimininkų naudotojų ID ir vietų skaičiai. Šeimininkų el. pašto adresai sąmoningai neįtraukiami.
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 }
]
}Grąžina visus objektus, priklausančius šeimininkams, kuriuos remia Jūsų partnerio paskyra. Naudokite tai norėdami sužinoti, kurių objektų kainodaros signalus galite užklausti.
marcus:read — suteikiama, kai Jūsų partnerio sutartyje yra Marcus Revenue Manager duomenų sluoksnis.
Kiekviename įraše yra vidinis objekto id (reikalingas pricing-signals galiniam taškui) ir objekto name. Su objektu nesusiję šeimininko PII duomenys neįtraukiami.
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" }
]
}Grąžina Marcus kainodaros signalus ir artėjantį užimtumą vienam remiamam objektui. Naudokite objekto id reikšmes, grąžintas iš GET /properties. Jei objektas nerandamas arba nepriklauso Jūsų partnerio paskyrai, grąžinamas 404.
marcus:read
lookback_days (sveikasis skaičius, numatytoji reikšmė 90) — rezervacijų istorijos laikotarpis, naudojamas signalams apskaičiuoti.
signals objektas apima kainodaros rodiklius ir rezervacijų statistiką. Tikslus laukų rinkinys gali keistis, Marcus pridedant naujus duomenų šaltinius. Toliau pateiktas pavyzdys rodo paleidimo metu prieinamus laukus — visus neatpažintus laukus laikykite papildomais.
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
}
}Vietoje REST užklausos partnerių remiami hostai įtraukiami per pasirašytą deep-link. Hostas jį paspaudžia, patenka į kainų nerodantį marketplace, kuriame pasirenka produktus, o jo Host Logic paskyra sukuriama — su partnerio parama ir be atskiro mokėjimo.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Kur {slug} yra unikalus Jūsų partnerio paskyros identifikatorius (pateikiamas įtraukimo metu), o token yra HMAC pasirašytas, trumpalaikis duomenų paketas, kuriame perduodami hosto tapatybės teiginiai.
Žetonai pasirašomi HMAC-SHA256 algoritmu naudojant Jūsų partnerio signing_secret (atskirą nuo Jūsų API rakto). Formatas yra toks:
<base64url-payload>.<sha256-hmac>
Duomenų pakete perduodami hosto tapatybės teiginiai, serverio pusėje nustatytas galiojimo pabaigos laikas (exp) ir atsitiktinis nonce, kad žetonas nebūtų panaudotas pakartotinai.
Numatyta reikšmė: 1 valanda. Pasibaigusio galiojimo žetonai atmetami su aiškia klaida — hostai turi paprašyti naujos nuorodos. Host Logic rekomenduoja nuorodas generuoti pagal poreikį (pvz., kai hostas paspaudžia mygtuką Jūsų sąsajoje), o ne jas saugoti.
Šiandien aktyvavimo žetonai pagal užklausą generuojami Host Logic administravimo įrankiu. Partnerio savitarnos žetonų generavimas (žetonų kūrimas programiškai iš Jūsų pačių backend'o) yra ateities plane — žr. toliau.
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"
}| Žingsnis | Kas vyksta |
|---|---|
| 1. Žetonas patvirtintas | Host Logic patvirtina HMAC parašą ir patikrina galiojimo laiką. Netinkami arba pasibaigusio galiojimo žetonai rodomi aiškiame klaidos puslapyje. |
| 2. Marketplace | Hostas patenka į kainų nerodantį produktų marketplace, pritaikytą Jūsų partnerio sutarčiai. Jis pasirenka, kuriuos produktus aktyvuoti. |
| 3. Paskyra sukurta | Sukuriama remiama Host Logic hosto paskyra (arba susiejama, jei el. paštas jau egzistuoja). Produktai aktyvuojami be mokėjimo žingsnio. |
| 4. Įvedimas į sistemą | Hostas nukreipiamas per Laura žinių bazės vedlį (atvykimo instrukcijos, DUK, papildomų paslaugų pasiūlymai). Laura pradeda atsakyti svečiams, kai vedlys užbaigiamas. |
Toliau pateiktos galimybės yra planuojamos arba kuriamos. Jos čia išvardytos skaidrumo tikslais, kad galėtumėte planuoti savo integracijos kelią. Šiuo metu nė viena iš jų dar nėra pasiekiama — bandant jas naudoti dabar bus gaunamos klaidos.
Partnerio savitarnos žetonų generavimas
API galinis taškas arba atsisiunčiamas SDK fragmentas, leidžiantis Jūsų backend'ui generuoti pasirašytus aktyvavimo žetonus neįtraukiant Host Logic. Šiandien žetonai generuojami pagal užklausą administravimo įrankiu.
Rašymo teisės ir keičiančios galinius taškus operacijos
Teisės, tokios kaip marcus:write ir pierre:write, bei REST galiniai taškai objektams registruoti (POST /properties), atskiriems vienetams aktyvuoti arba deaktyvuoti ir partnerio nustatymams atnaujinti.
Webhook'ai / realaus laiko įvykiai
Pranešimai apie užbaigtą įtraukimą, vieneto aktyvavimą / deaktyvavimą ir naudojimo ribas. Užregistruokite webhook URL ir gaukite pasirašytus duomenų paketus.
Partnerio savitarnos portalas
Savitarnos portalas su įjungimo vėliavėle API raktams valdyti, vietų naudojimui peržiūrėti ir leidžiamiems įterpimo originams konfigūruoti. Šiuo metu privati beta versija.
Pierre priežiūros galinis taškas
GET /properties/{propertyId}/operational-state — sponsoruoto objekto priežiūros ir veikimo būsena. Sukurtas, bet išjungtas naudojant funkcijos vėliavą; reikalinga pierre:read prieiga. Prieinamas atrinktiems partneriams pagal užklausą.
Įdiegimo vedlio įterpimas per iframe
Įterpkite Laura konfigūravimo vedlį kaip iframe į savo PMS sąsają, naudojant postMessage įvykius žingsnių eigai ir užbaigimui. Priklauso nuo partnerių savitarnos portalo paleidimo.
Priglobtas MCP serveris įmonėms
Priglobtas MCP galinis taškas adresu mcp.hostlogic.io, suteikiantis Claude Desktop / Cursor įrankių prieigą prie partneriui priskirtų duomenų. Architektūra suplanuota; įmonių partneriams dar neprieinama.
Įmonių partneriai turi atskirą Slack kanalą su Host Logic komanda. Susisiekite adresu [email protected], kad aptartume Jūsų integracijos poreikius ir terminus.
Papasakokite apie savo PMS, kanalų valdymo sistemą arba svetingumo programinės įrangos produktą. Partnerių paraiškas peržiūrime per 2 darbo dienas ir suteikiame Jums API raktą bei atskirą palaikymo kanalą.