Csak olvasható adat-API és partner-aktivációs deep-link a Host Logic MI-ügynökeinek az Ön PMS-ébe vagy ingatlankezelő platformjába való integrálásához. Ez az oldal kizárólag azt dokumentálja, ami ma élő — az egyértelműen megjelölt Roadmap szakasz mutatja be a hamarosan érkező funkciókat.
Szerezze meg az API-kulcsát → olvassa ki a seat-használatot és az árazási jelzéseket → ágyazza be a host-aktivációs linket a saját felületébe. Ez a teljes, ma elérhető integrációs hurok.
Szerezze meg az API-kulcsát
Váljon partnerré. A jóváhagyás után a Host Logic létrehozza az Ön partnerfiókját, és küld egy egyszer megjeleníthető feltárási linket, amely tartalmazza az hlk_ API-kulcsát. Tárolja biztonságosan — a feltárás után többé nem jeleníthető meg.
Olvassa ki a használati & árazási jelzéseket
Hívja a GET /partner-api/v1/usage végpontot a seat-fogyasztás nyomon követéséhez, és a GET /partner-api/v1/properties/{id}/pricing-signals végpontot a Marcus árazási adatainak a saját platformján való megjelenítéséhez.
Ágyazza be az aktivációs linket
Adjon hozzá egy gombot a felületéhez, amely megnyitja a HMAC-aláírt deep-linket: https://hostlogic.io/partner/{slug}/activate?token=…. A host kiválasztja a termékeket, létrejön a Host Logic fiókja, és Laura készen áll.
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)Minden API-kérés Bearer tokent igényel az Authorization fejlécben. Az API-kulcsát a partner-jóváhagyás után, egy egyszer megjeleníthető feltárási linken keresztül kapja meg — a nyílt kulcs sosem kerül szerveroldali tárolásra, és nem jeleníthető meg újra.
Az API-kulcsok hlk_ előtaggal rendelkeznek, az Ön partnerfiókjához vannak kötve, és leállás nélkül forgathatók. Minden kulcs egy scope-készletet hordoz, amely meghatározza, mely végpontokat hívhatja. Minden kulcs első 12 karaktere (a kulcs előtagja) nyílt szövegként tárolódik a naplókban való azonosításhoz — a többi hash-elve van.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
API-kulcsonként 120 kérés/perc. A túllépés 429 Too Many Requests választ ad.
metrics:read — mindig megadva; lefedi a használati végpontot.marcus:read — akkor megadva, ha az Ön partnermegállapodása tartalmazza a Marcus (Revenue Manager) adatokat; lefedi az ingatlan- és árazásijelzés-végpontokat.
| Kód | Jelentés |
|---|---|
401 | Hiányzó vagy érvénytelen API-kulcs |
403 | A kulcs érvényes, de hiányzik a végponthoz szükséges scope |
404 | Az erőforrás nem található, vagy nem az Ön partnerfiókjához tartozik |
429 | Rátalimit túllépve — 120 kérés/perc |
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"Az alábbi végpontok és integrációs minták ma már éles üzemben vannak. Minden itt felsorolt elem valós és hívható egy érvényes API-kulccsal.
/usage
Seat-használat az Ön partnerfiókjához. Scope: metrics:read (mindig megadva). Lásd a teljes referenciát lentebb.
/properties
Az Ön által szponzorált hostok ingatlanjainak listája. Scope: marcus:read. Lásd a teljes referenciát lentebb.
/properties/{propertyId}/pricing-signals
Marcus árazási jelzések és várható foglaltság egy szponzorált ingatlanhoz. Scope: marcus:read. Lásd a teljes referenciát lentebb.
Partner-aktivációs deep-link
HMAC-aláírt URL, amely létrehoz egy szponzorált host-fiókot. Gombként ágyazza be a felületébe. Lásd a teljes referenciát lentebb.
Visszaadja a hitelesített partner aktív seat-számát host-szintű bontással. Hasznos a számlázás egyeztetéséhez vagy egy használati irányítópult felépítéséhez a saját platformján.
metrics:read — minden partnerkulcshoz mindig megadva.
Ez a végpont kizárólag a hitelesített partner adatait adja vissza. Sosem fogad el partner_id lekérdezési paramétert — az azonosság teljes egészében az Ön API-kulcsából származik.
A bontás átlátszatlan host-felhasználó-azonosítókat és seat-számokat használ. A host-e-mail-címek szándékosan kimaradnak.
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 }
]
}Visszaadja az Ön partnerfiókja által szponzorált hostokhoz tartozó összes ingatlant. Ezzel deríthető ki, mely ingatlanokra kérdezhet le árazási jelzéseket.
marcus:read — akkor megadva, ha az Ön partnermegállapodása tartalmazza a Marcus Revenue Manager adatsíkot.
Minden bejegyzés tartalmazza a belső ingatlan-id-t (amely az árazásijelzés-végponthoz szükséges) és az ingatlan name mezőjét. Az ingatlannéven túli host-PII kimarad.
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" }
]
}Visszaadja a Marcus árazási jelzéseit és a várható foglaltságot egyetlen szponzorált ingatlanhoz. Használja a GET /properties által visszaadott ingatlan-id értékeket. 404 választ ad, ha az ingatlan nem található, vagy nem az Ön partnerfiókjához tartozik.
marcus:read
lookback_days (egész szám, alapértelmezés 90) — a jelzések kiszámításához használt foglalástörténeti ablak.
A signals objektum árazási indikátorokat és foglalási statisztikákat tartalmaz. A pontos mezőkészlet változhat, ahogy a Marcus új adatforrásokat vesz fel. Az alábbi reprezentatív példa az induláskor elérhető mezőket mutatja — bármely fel nem ismert mezőt kezeljen additívként.
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
}
}REST-hívás helyett a partner által szponzorált hostok egy aláírt deep-linken keresztül kerülnek beléptetésre. A host rákattint, egy ár nélküli piactérre érkezik, ahol termékeket választ, és létrejön a Host Logic fiókja — szponzoráltan, külön fizetés nélkül.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Ahol a {slug} az Ön partnerfiókjának egyedi azonosítója (a beléptetéskor megadva), a token pedig egy HMAC-aláírt, rövid élettartamú payload, amely host-azonossági állításokat hordoz.
A tokenek HMAC-SHA256-tal vannak aláírva az Ön partnerének signing_secret értékével (amely elkülönül az API-kulcstól). A formátum a következő:
<base64url-payload>.<sha256-hmac>
A payload host-azonossági állításokat, egy szerveroldali lejárati időbélyeget (exp) és egy véletlenszerű nonce-t hordoz a token újrafelhasználásának megakadályozásához.
Alapértelmezés: 1 óra. A lejárt tokenek egyértelmű hibával elutasításra kerülnek — a hostoknak új linket kell kérniük. A Host Logic azt javasolja, hogy a linkeket igény szerint generálja (pl. amikor egy host rákattint egy gombra a felületén), ahelyett, hogy tárolná őket.
Ma az aktivációs tokeneket a Host Logic generálja igény szerint egy admin eszközzel. A partner önkiszolgáló tokengenerálás (tokenek programozott létrehozása a saját backendjéből) a Roadmapen szerepel — lásd lentebb.
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"
}| Lépés | Mi történik |
|---|---|
| 1. Token ellenőrizve | A Host Logic validálja a HMAC-aláírást és ellenőrzi a lejáratot. Az érvénytelen vagy lejárt tokenek egyértelmű hibaoldalt jelenítenek meg. |
| 2. Piactér | A host egy ár nélküli termékpiactérre érkezik, amely az Ön partnermegállapodásához van szűkítve. Kiválasztja, mely termékeket aktiválja. |
| 3. Fiók létrehozva | Létrejön egy szponzorált Host Logic host-fiók (vagy összekapcsolódik, ha az e-mail-cím már létezik). A termékek fizetési lépés nélkül aktiválódnak. |
| 4. Beléptetés | A hostot végigvezeti Laura tudásbázis-varázslója (bejelentkezési utasítások, GYIK-ek, upsell-ajánlatok). Laura a varázsló beküldése után kezdi el válaszolni a vendégeket. |
Az alábbi képességek tervezés vagy fejlesztés alatt állnak. Az átláthatóság kedvéért soroljuk fel őket itt, hogy megtervezhesse az integrációs ütemtervét. Ezek egyike sem hívható ma — a mostani fejlesztés ellenük hibákat eredményez.
Partner önkiszolgáló tokengenerálás
Egy API-végpont vagy letölthető SDK-részlet, amely lehetővé teszi, hogy a backendje a Host Logic bevonása nélkül generáljon aláírt aktivációs tokeneket. Ma a tokeneket igény szerint, egy admin eszközzel generáljuk.
Write scope-ok & módosító végpontok
Olyan scope-ok, mint a marcus:write és a pierre:write, valamint REST-végpontok ingatlanok regisztrálásához (POST /properties), egyes egységek aktiválásához vagy deaktiválásához, és a partnerbeállítások frissítéséhez.
Webhookok / valós idejű események
Push-értesítések a beléptetés befejeződéséről, egység aktiválásáról/deaktiválásáról és a használati küszöbökről. Regisztráljon egy webhook-URL-t, és fogadjon aláírt payloadokat.
Partner önkiszolgáló portál
Egy flag-gated önkiszolgáló portál az API-kulcsok kezeléséhez, a seat-használat megtekintéséhez és az engedélyezett beágyazási origók konfigurálásához. Jelenleg zárt bétában.
Pierre karbantartási végpont
GET /properties/{propertyId}/operational-state — karbantartási és üzemeltetési állapot egy szponzorált ingatlanhoz. Megépült, de feature flaggel letiltva; pierre:read scope-ot igényel. Kiválasztott partnereknek igény szerint elérhető.
Beléptetési iframe-beágyazás
Ágyazza be Laura konfigurációs varázslóját iframe-ként a PMS-felületébe, postMessage eseményekkel a lépések előrehaladásáról és a befejezésről. A partner önkiszolgáló portál elindításától függ.
Hosztolt MCP-szerver enterprise-hoz
Egy hosztolt MCP-végpont az mcp.hostlogic.io címen, amely Claude Desktop / Cursor eszközhozzáférést biztosít a partner-szintű adatokhoz. Az architektúra tervezett; enterprise partnerek számára még nem élő.
Az enterprise partnerek dedikált Slack-csatornával rendelkeznek a Host Logic csapatával. Írjon a [email protected] címre, hogy megbeszéljük az integrációs igényeit és ütemtervét.
Meséljen a PMS-éről, csatornamenedzseréről vagy vendéglátószoftver-termékéről. A partnerkérelmeket 2 munkanapon belül elbíráljuk, és biztosítjuk az API-kulcsát és dedikált támogatási csatornáját.