API danych tylko do odczytu oraz deep link aktywacyjny partnera do integracji agentów AI Host Logic z Państwa PMS lub platformą do zarządzania obiektem. Ta strona dokumentuje wyłącznie to, co jest dziś dostępne — wyraźnie oznaczona sekcja Roadmap obejmuje to, co pojawi się w kolejnym etapie.
Pobierz klucz API → odczytuj wykorzystanie miejsc i sygnały cenowe → osadź link aktywacyjny hosta w swoim interfejsie. To pełny proces integracji dostępny już dziś.
Pobierz klucz API
Zostań partnerem. Po zatwierdzeniu Host Logic tworzy Państwa konto partnerskie i wysyła jednorazowy link do ujawnienia, zawierający klucz API hlk_. Proszę przechowywać go bezpiecznie — po ujawnieniu nie można go wyświetlić ponownie.
Odczytuj użycie i sygnały cenowe
Wywołaj GET /partner-api/v1/usage, aby monitorować wykorzystanie miejsc, oraz GET /partner-api/v1/properties/{id}/pricing-signals, aby wyświetlać dane cenowe Marcus w swojej platformie.
Osadź link aktywacyjny
Dodaj w swoim interfejsie przycisk, który otwiera podpisany HMAC deep link https://hostlogic.io/partner/{slug}/activate?token=…. Host wybiera produkty, jego konto Host Logic zostaje skonfigurowane, a Laura jest gotowa.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — klucz jest prawidłowy, odpowiedź zawiera wykorzystanie miejsc
# 401 Unauthorized — brak klucza lub jest on nieprawidłowy
# 403 Forbidden — klucz jest prawidłowy, ale brakuje wymaganego zakresu
# 429 Too Many Requests — limit zapytań (120 żądań/min)Wszystkie żądania API wymagają tokenu Bearer w nagłówku Authorization. Klucz API otrzymują Państwo po zatwierdzeniu partnera za pośrednictwem jednorazowego linku do ujawnienia — jawny klucz nigdy nie jest przechowywany po stronie serwera i nie można go ponownie wyświetlić.
Klucze API mają prefiks hlk_, są przypisane do Państwa konta partnerskiego i można je rotować bez przestojów. Każdy klucz ma zestaw zakresów, które określają, do których endpointów może się odwoływać. Pierwsze 12 znaków każdego klucza (prefiks klucza) są przechowywane w postaci jawnej do identyfikacji w logach — reszta jest haszowana.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 żądań/minutę na klucz API. Po przekroczeniu zwracany jest kod 429 Too Many Requests.
metrics:read — zawsze przyznawany; obejmuje endpoint usage.marcus:read — przyznawany, gdy umowa partnerska obejmuje dane Marcus (Revenue Manager); obejmuje endpointy properties i pricing-signals.
| Kod | Znaczenie |
|---|---|
401 | Brak klucza API lub jest on nieprawidłowy |
403 | Klucz jest prawidłowy, ale brakuje wymaganego zakresu dla tego endpointu |
404 | Zasób nie został znaleziony lub nie należy do konta Państwa partnera |
429 | Przekroczono limit żądań — 120 żądań/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"Poniższe endpointy i wzorce integracji są już dostępne w środowisku produkcyjnym. Wszystko wymienione poniżej jest rzeczywiste i można to wywołać przy użyciu prawidłowego klucza API.
/usage
Wykorzystanie miejsc dla konta Państwa partnera. Zakres: metrics:read (zawsze przyznawany). Zobacz pełną dokumentację poniżej.
/properties
Lista obiektów należących do hostów objętych sponsoringiem przez Państwa partnera. Zakres: marcus:read. Zobacz pełną dokumentację poniżej.
/properties/{propertyId}/pricing-signals
Sygnały cenowe Marcus i nadchodzące obłożenie dla obiektu objętego sponsoringiem. Zakres: marcus:read. Zobacz pełną dokumentację poniżej.
Deep link aktywacyjny dla partnera
Adres URL podpisany HMAC, który tworzy konto hosta objętego sponsoringiem. Osadzany w Państwa interfejsie jako przycisk. Zobacz pełną dokumentację poniżej.
Zwraca liczbę aktywnych miejsc zalogowanego partnera z podziałem na poszczególnych hostów. Przydatne do uzgadniania rozliczeń lub budowy panelu wykorzystania w Państwa platformie.
metrics:read — zawsze przyznawany wszystkim kluczom partnera.
Ten endpoint zwraca dane wyłącznie dla uwierzytelnionego partnera. Nigdy nie akceptuje parametru zapytania partner_id — tożsamość wynika wyłącznie z Państwa klucza API.
Podział wykorzystuje niejawne identyfikatory użytkowników hostów oraz liczbę miejsc. Adresy e-mail hostów są celowo wykluczone.
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 }
]
}Zwraca wszystkie obiekty należące do hostów sponsorowanych przez Państwa konto partnera. Użyj tego, aby sprawdzić, dla których obiektów mogą Państwo pobierać sygnały cenowe.
marcus:read — przyznawany, gdy umowa partnerska obejmuje warstwę danych Marcus Revenue Manager.
Każdy wpis zawiera wewnętrzny identyfikator obiektu id (wymagany przez endpoint pricing-signals) oraz nazwę obiektu name. Dane osobowe hosta poza nazwą obiektu są wykluczone.
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" }
]
}Zwraca sygnały cenowe Marcus oraz nadchodzące obłożenie dla jednego sponsorowanego obiektu. Użyj wartości id obiektu zwróconych przez GET /properties. Jeśli obiekt nie zostanie znaleziony lub nie należy do konta Państwa partnera, zwracany jest kod 404.
marcus:read
lookback_days (liczba całkowita, domyślnie 90) — okno historii rezerwacji używane do obliczania sygnałów.
Obiekt signals zawiera wskaźniki cenowe oraz statystyki rezerwacji. Dokładny zestaw pól może się zmieniać wraz z dodawaniem przez Marcus nowych źródeł danych. Poniższy przykładowy zestaw pokazuje pola dostępne przy uruchomieniu — wszelkie nierozpoznane pola należy traktować jako dodatkowe.
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
}
}Zamiast wywołania REST partnerowi sponsorowani hostowie są onboardowani za pomocą podpisanego deep linku. Host klika go, trafia do marketplace’u bez cen, wybiera produkty, a jego konto Host Logic zostaje utworzone — sponsorowane i bez konieczności osobnej płatności.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Gdzie {slug} to unikalny identyfikator konta partnera (przekazany podczas onboardingu), a token to podpisany HMAC, krótkotrwały ładunek zawierający deklaracje tożsamości hosta.
Tokeny są podpisywane algorytmem HMAC-SHA256 przy użyciu signing_secret partnera (oddzielnego od klucza API). Format jest następujący:
<base64url-payload>.<sha256-hmac>
Ładunek zawiera deklaracje tożsamości hosta, serwerowy znacznik wygaśnięcia (exp) oraz losowy nonce, aby zapobiec ponownemu użyciu tokenu.
Domyślnie: 1 godzina. Wygasłe tokeny są odrzucane z czytelnym komunikatem o błędzie — host musi poprosić o nowy link. Host Logic zaleca generowanie linków na żądanie (np. gdy host kliknie przycisk w Państwa interfejsie), zamiast ich przechowywania.
Obecnie tokeny aktywacyjne są generowane na żądanie przez Host Logic za pomocą narzędzia administracyjnego. Samoobsługowe generowanie tokenów przez partnera (programowe generowanie tokenów z własnego backendu) znajduje się na Roadmapie — patrz poniżej.
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 | Co się dzieje |
|---|---|
| 1. Token zweryfikowany | Host Logic weryfikuje podpis HMAC i sprawdza datę wygaśnięcia. Nieprawidłowe lub wygasłe tokeny wyświetlają czytelną stronę błędu. |
| 2. Marketplace | Host trafia do marketplace’u produktów bez cen, przypisanego do Państwa umowy partnerskiej. Wybiera, które produkty aktywować. |
| 3. Konto utworzone | Tworzone jest sponsorowane konto hosta Host Logic (lub następuje jego powiązanie, jeśli adres e-mail już istnieje). Produkty są aktywowane bez etapu płatności. |
| 4. Onboarding | Host przechodzi przez kreator bazy wiedzy Laury (instrukcje zameldowania, FAQ, oferty upsell). Laura zaczyna odpowiadać gościom po przesłaniu kreatora. |
Poniższe funkcje są planowane lub w trakcie tworzenia. Zostały tu wymienione dla przejrzystości, aby mogli Państwo zaplanować integrację. Żadna z nich nie jest obecnie dostępna do wywołania — budowanie integracji w oparciu o nie spowoduje błędy.
Samoobsługowe generowanie tokenów przez partnera
Punkt końcowy API lub fragment SDK do pobrania, który pozwoli Państwa backendowi generować podpisane tokeny aktywacyjne bez udziału Host Logic. Obecnie tokeny są generowane na żądanie za pomocą narzędzia administracyjnego.
Zakresy zapisu i endpointy modyfikujące
Zakresy takie jak marcus:write i pierre:write oraz endpointy REST do rejestrowania obiektów (POST /properties), aktywowania lub dezaktywowania pojedynczych jednostek i aktualizowania ustawień partnera.
Webhooki / zdarzenia w czasie rzeczywistym
Powiadomienia push o zakończonym onboardingu, aktywacji/dezaktywacji jednostki oraz progach użycia. Zarejestruj adres URL webhooka i odbieraj podpisane ładunki.
Portal samoobsługowy partnera
Portal samoobsługowy z flagą funkcji do zarządzania kluczami API, podglądu wykorzystania miejsc i konfiguracji dozwolonych źródeł osadzania. Obecnie w prywatnej becie.
Punkt końcowy konserwacji Pierre
GET /properties/{propertyId}/operational-state — stan konserwacji i stan operacyjny dla obiektu sponsorowanego. Zbudowany, ale wyłączony flagą funkcji; wymaga zakresu pierre:read. Dostępny dla wybranych partnerów na życzenie.
Osadzanie onboardingu w iframe
Osadź kreator konfiguracji Laura jako iframe w interfejsie PMS, z wydarzeniami postMessage dotyczącymi postępu kroków i zakończenia. Zależne od uruchomienia portalu samoobsługowego dla partnerów.
Hostowany serwer MCP dla enterprise
Hostowany punkt końcowy MCP pod adresem mcp.hostlogic.io, zapewniający dostęp narzędzi Claude Desktop / Cursor do danych w zakresie partnera. Architektura jest planowana; dla partnerów enterprise nie jest jeszcze uruchomiony.
Partnerzy enterprise mają dedykowany kanał Slack z zespołem Host Logic. Prosimy o kontakt pod adresem [email protected], aby omówić wymagania integracyjne i harmonogram.
Prosimy opowiedzieć nam o swoim PMS, channel managerze lub produkcie z obszaru oprogramowania hotelarskiego. Wnioski partnerskie analizujemy w ciągu 2 dni roboczych i zapewniamy klucz API oraz dedykowany kanał wsparcia.