API за податоци само за читање и deep-link за активација на партнерот за интегрирање на AI агентите на Host Logic во Вашиот PMS или платформа за управување со објекти. Оваа страница документира само она што е live денес — јасно означен дел Roadmap ги опфаќа следните чекори.
Земете го Вашиот API клуч → прочитајте го користењето на седишта и ценовните сигнали → вградете го линкот за активација на домаќинот во Вашиот интерфејс. Тоа е целиот интеграциски тек што е достапен денес.
Земете го Вашиот API клуч
Станете партнер. Откако ќе бидете одобрени, Host Logic ќе Ви отвори партнерска сметка и ќе Ви испрати еднократен линк за откривање што го содржи Вашиот hlk_ API клуч. Чувајте го безбедно — по откривањето не може повторно да се прикаже.
Прочитајте користење & ценовни сигнали
Повикајте GET /partner-api/v1/usage за да го следите користењето на седишта, и GET /partner-api/v1/properties/{id}/pricing-signals за да ги прикажете ценовните податоци на Marcus во Вашата платформа.
Вградете го линкот за активација
Додајте копче во Вашиот интерфејс што го отвора HMAC-потпишаниот deep-link https://hostlogic.io/partner/{slug}/activate?token=…. Домаќинот ги избира производите, неговата Host Logic сметка се конфигурира, а Laura е подготвена.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — клучот е валиден, одговорот го содржи Вашето користење на седишта
# 401 Unauthorized — клучот недостасува или е неважечки
# 403 Forbidden — клучот е валиден, но недостасува потребниот опсег
# 429 Too Many Requests — ограничување на брзината (120 барања/мин)Сите API барања бараат Bearer токен во заглавието Authorization. Вашиот API клуч го добивате по одобрување на партнерството преку еднократен линк за откривање — обичниот клуч никогаш не се чува на серверската страна и не може повторно да се прикаже.
API клучевите имаат префикс hlk_, се поврзани со Вашата партнерска сметка и може да се ротираат без прекин во работата. Секој клуч носи збир на опсези што одредуваат кои endpoint-и може да ги повикува. Првите 12 знаци од секој клуч (префиксот на клучот) се чуваат во обичен текст за идентификација во логови — остатокот е хеширан.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 барања/минута по API клуч. При надминување се враќа 429 Too Many Requests.
metrics:read — секогаш доделен; го опфаќа endpoint-от за користење.marcus:read — се доделува кога Вашиот партнерски договор вклучува податоци за Marcus (Revenue Manager); ги опфаќа endpoint-ите properties и pricing-signals.
| Код | Значење |
|---|---|
401 | Недостасува или е неважечки API клуч |
403 | Клучот е валиден, но недостасува потребниот опсег за овој endpoint |
404 | Ресурсот не е пронајден или не е во сопственост на Вашата партнерска сметка |
429 | Надминат е лимитот на барања — 120 барања/мин |
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"Следните крајни точки и интеграциски модели се веќе во продукција. Сѐ што е наведено тука е реално и може да се повика со важечки API клуч.
/usage
Користење на места за Вашата партнерска сметка. Опсег: metrics:read (секогаш одобрен). Погледнете ја целосната референца подолу.
/properties
Листа на објекти што им припаѓаат на Вашите спонзорирани домаќини. Опсег: marcus:read. Погледнете ја целосната референца подолу.
/properties/{propertyId}/pricing-signals
Ценовни сигнали на Marcus и претстојна пополнетост за спонзиран објект. Опсег: marcus:read. Погледнете ја целосната референца подолу.
Длабинска врска за активирање на партнер
URL со HMAC потпис што обезбедува сметка за спонзиран домаќин. Вградено во Вашиот интерфејс како копче. Погледнете ја целосната референца подолу.
Го враќа бројот на активни места на автентицираниот партнер, со преглед по домаќин. Корисно за усогласување на наплатата или за изработка на контролна табла за користење во Вашата платформа.
metrics:read — секогаш одобрен за сите партнерски клучеви.
Оваа крајна точка враќа податоци само за автентицираниот партнер. Никогаш не прифаќа параметар за пребарување partner_id — идентитетот целосно доаѓа од Вашиот API клуч.
Прегледот користи анонимни ID-а на корисници на домаќини и број на места. Е-поштите на домаќините намерно се исклучени.
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 }
]
}Ги враќа сите објекти што им припаѓаат на домаќините што ги спонзорира Вашата партнерска сметка. Користете го ова за да откриете за кои објекти можете да барате ценовни сигнали.
marcus:read — се одобрува кога Вашиот партнерски договор го вклучува data plane-от на Marcus Revenue Manager.
Секој запис го содржи внатрешниот id на објектот (потребен за крајната точка за pricing-signals) и name на објектот. PII на домаќинот, освен името на објектот, е исклучена.
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" }
]
}Ги враќа ценовните сигнали на Marcus и претстојната пополнетост за еден спонзиран објект. Користете ги вредностите на id на објектот вратени од GET /properties. Се враќа 404 ако објектот не е пронајден или не е во сопственост на Вашата партнерска сметка.
marcus:read
lookback_days (цел број, стандардно 90) — временски прозорец на историјата на резервации што се користи за пресметување на сигналите.
Објектот signals содржи ценовни индикатори и статистика за резервации. Точниот сет на полиња може да се развива како што Marcus додава нови извори на податоци. Репрезентативниот пример подолу ги прикажува полињата достапни при лансирањето — сите непрепознаени полиња третирајте ги како дополнителни.
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 повик, домаќините спонзорирани од партнер се вклучуваат преку потпишана длабинска врска. Домаќинот кликнува на неа, пристигнува на пазар без цени каде што избира производи, а неговата сметка во Host Logic се креира — спонзорирана и без потреба од посебно плаќање.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Каде што {slug} е единствениот идентификатор на вашата партнерска сметка (добиен при вклучување), а token е HMAC-потпишан, краткотраен payload што носи тврдења за идентитетот на домаќинот.
Токените се потпишуваат со HMAC-SHA256 користејќи го signing_secret на вашиот партнер (одделно од вашиот API клуч). Форматот е:
<base64url-payload>.<sha256-hmac>
Payload-от носи тврдења за идентитетот на домаќинот, временска ознака за истекување на серверска страна (exp) и случаен nonce за да се спречи повторна употреба на токенот.
Стандардно: 1 час. Истечените токени се одбиваат со јасна порака за грешка — домаќините мора да побараат нова врска. Host Logic препорачува генерирање на врските по потреба (на пр., кога домаќин ќе кликне на копче во вашето UI), наместо нивно складирање.
Денес, активациските токени се генерираат преку админ алатка од Host Logic по барање. Самостојно генерирање токени од страна на партнерот (генерирање токени програмски од ваш backend) е на Roadmap — видете подолу.
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"
}| Чекор | Што се случува |
|---|---|
| 1. Токенот е потврден | Host Logic ја валидира HMAC потписот и ја проверува важноста. Неважечките или истечените токени прикажуваат јасна страница за грешка. |
| 2. Пазар | Домаќинот пристигнува на пазар на производи без цени, ограничен според вашиот партнерски договор. Тој избира кои производи да ги активира. |
| 3. Сметката е креирана | Се креира спонзорирана сметка на домаќин во Host Logic (или се поврзува ако е-поштата веќе постои). Производите се активираат без чекор за плаќање. |
| 4. Вклучување | Домаќинот се води низ wizard-от на базата на знаење на Laura (инструкции за пријавување, FAQ, понуди за upsell). Laura почнува да одговара на гостите штом wizard-от биде поднесен. |
Следните можности се планирани или се во развој. Тука се наведени за транспарентност, за да можете да го планирате вашиот интеграциски roadmap. Ниту една од нив денес не може да се повикува — ако градите врз нив сега, ќе добиете грешки.
Самостојно генерирање токени од страна на партнерот
API endpoint или преземлив SDK примерок што му овозможува на вашиот backend да генерира потпишани активациски токени без вклучување на Host Logic. Денес токените се генерираат по барање преку админ алатка.
Write-опсези и endpoint-и што менуваат податоци
Scopes како marcus:write и pierre:write и REST endpoints за регистрирање објекти (POST /properties), активирање или деактивирање на поединечни единици и ажурирање на партнерските поставки.
Webhooks / настани во реално време
Push известувања за завршено вклучување, активирана/деактивирана единица и прагови на користење. Регистрирајте webhook URL и примајте потпишани payload-и.
Самостоен партнерски портал
Самостоен портал со flag за управување со API клучеви, преглед на користење на места и конфигурирање на дозволени embed origins. Моментално во приватна бета.
Ендпоинт за одржување Pierre
GET /properties/{propertyId}/operational-state — состојба на одржување и оперативна состојба за спонзорирана сместувачка единица. Изградено, но оневозможено со feature flag; бара pierre:read scope. Достапно за избрани партнери по барање.
Вградување на onboarding iframe
Вградете го конфигурацискиот wizard на Laura како iframe во вашиот PMS UI, со postMessage настани за напредокот низ чекорите и завршувањето. Зависи од лансирањето на self-service порталот за партнери.
Хостиран MCP сервер за enterprise
Хостиран MCP ендпоинт на mcp.hostlogic.io што обезбедува пристап од Claude Desktop / Cursor до податоци во рамки на партнерскиот опсег. Архитектурата е планирана; сѐ уште не е активна за enterprise партнери.
Enterprise партнерите имаат посебен Slack канал со тимот на Host Logic. Контактирајте нѐ на [email protected] за да ги разгледаме вашите интеграциски барања и временска рамка.
Кажете ни повеќе за вашиот PMS, channel manager или софтверски производ за угостителство. Ги разгледуваме партнерските апликации во рок од 2 работни дена и ви обезбедуваме API клуч и посебен канал за поддршка.