Živé API pre partnerské integrácie
Best Guest pripravuje API, vďaka ktorému budú môcť PMS systémy, channel manageri a rezervačné enginy ponúknuť svojim zákazníkom registráciu hostí podľa pravidiel jednotlivých európskych krajín priamo vo svojom produkte.
Prečo integrovať Best Guest
Vaši zákazníci pôsobiaci naprieč Európou potrebujú registráciu hostí, hlásenie miestnym úradom a súlad s miestnym poplatkom za ubytovanie — a pravidlá sa v každej krajine líšia. Best Guest to zabezpečuje — váš produkt to môže ponúknuť ako vstavanú funkciu, namiesto toho, aby zákazníkov posielal inam.
Možnosti
Čo API dnes podporuje. Niekoľko častí je zatiaľ na ceste — sú označené.
Reservation API
Odošlite rezervácie do Best Guest a registrácia hosta sa spustí automaticky.
Check-in API
Spúšťajte a sledujte online check-in hostí priamo z vášho produktu.
Compliance API
Čítajte stav registrácie, záznamy knihy ubytovaných a výpočty poplatkov.
Hlásenie miestnym úradom
Hlásenia hostí podávané miestnym úradom v mene vašich zákazníkov — automatizované tam, kde existuje oficiálny systém (UbyPort v Česku beží v ostrej prevádzke), inde formou pripravených dokumentov na podanie tam, kde verejné API zatiaľ neexistuje.
Webhooky (plánované)
Udalosti v reálnom čase pre dokončenie registrácie, hlásenie poplatkov a zmeny rezervácií — plánujeme v blízkej budúcnosti; zatiaľ stav rezervácie zistíte dotazom na API.
Sandbox
Pre vývoj a overenie integrácie vám pred ostrým nasadením pripravíme testovací pracovný priestor.
SDK
Plánované klientské knižnice pre rýchlejšiu integráciu s bežnými partnerskými technológiami.
Bezpečnosť a umiestnenie dát
Spracovanie dát hostí v súlade s GDPR, hostované v EÚ.
Ako získať prístup
Dve cesty, podľa toho, čo staviate.
Vlastný API kľúč
Ste už zákazníkom Best Guest? Vygenerujte si vlastný kľúč s obmedzeným rozsahom, ktorý môžete kedykoľvek zrušiť — v Nastavenia → Prístup k API. Bez schvaľovania.
Integrácia platformy
Integrujete Best Guest do channel manažera, PMS alebo rezervačného enginu, ktorý používa viacero zákazníkov naraz? Povedzte nám o svojom produkte nižšie a nastavíme vás ako integračného partnera.
Živá ukážka
POST /v1/upsertReservation
Authorization: {partner_api_key}
Content-Type: application/json
{
"externalId": "your-own-booking-id",
"accommodationId": 4821,
"listingIds": [10432],
"fromDate": "2026-08-14",
"toDate": "2026-08-18",
"personsCount": 2,
"countryOfResidence": "Germany",
"recipientLanguage": "en",
"email": "guest@example.com"
}
→ HTTP 200
{
"result": true,
"data": {
"reservationId": 9310,
"externalId": "your-own-booking-id",
"created": true,
"status": "NOT_COMPLETED",
"checkinUrl": "https://bestguest.app/..."
}
} Toto je skutočný tvar požiadavky a odpovede zo živého API — nie mockup.
Žiadosť o prístup k API
Povedzte nám o svojom produkte a ozveme sa vám ohľadom partnerstva.
Žiadosť prijatá
Ďakujeme — náš tím vašu žiadosť posúdi a čoskoro sa vám ozve.