Živé API pro partnerské integrace
Best Guest nabízí API, díky kterému mohou PMS systémy, channel manažeři a rezervační enginy nabídnout svým zákazníkům registraci hostů podle českých zákonů přímo ve svém produktu.
Proč integrovat Best Guest
Vaši čeští zákazníci potřebují registraci hostů, hlášení UbyPort, připravenost na e-Turistu a soulad s místním poplatkem z pobytu. Best Guest to zajišťuje — váš produkt to může nabídnout jako vestavěnou funkci, místo aby zákazníky posílal jinam.
Možnosti
Co API dnes podporuje. Několik částí je zatím na cestě — jsou označené.
Reservation API
Odešlete rezervace do Best Guest a registrace hosta se spustí automaticky.
Check-in API
Spouštějte a sledujte online check-in hostů přímo z vašeho produktu.
Compliance API
Čtěte stav registrace, záznamy domovní knihy a výpočty poplatků.
Hlášení UbyPort
Hlášení cizinců podávané českým úřadům jménem vašich zákazníků.
Webhooky (plánované)
Události v reálném čase pro dokončení registrace, hlášení poplatků a změny rezervací — plánujeme v blízké budoucnosti; zatím stav rezervace zjistíte dotazem na API.
Sandbox
Pro vývoj a ověření integrace vám před ostrým nasazením připravíme testovací pracovní prostor.
SDK
Plánované klientské knihovny pro rychlejší integraci s běžnými partnerskými technologiemi.
Bezpečnost a umístění dat
Zpracování dat hostů v souladu s GDPR, hostováno v EU.
Jak získat přístup
Dvě cesty, podle toho, co stavíte.
Vlastní API klíč
Jste už zákazníkem Best Guest? Vygenerujte si vlastní klíč s omezeným rozsahem, který můžete kdykoli zrušit — v Nastavení → Přístup k API. Bez schvalování.
Integrace platformy
Integrujete Best Guest do channel manageru, PMS nebo rezervačního enginu, který používá více zákazníků najednou? Řekněte nám o svém produktu níže a nastavíme vás jako integračního partnera.
Živá ukázka
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 skutečný tvar požadavku a odpovědi ze živého API — ne mockup.
Žádost o přístup k API
Řekněte nám o svém produktu a ozveme se vám ohledně partnerství.
Žádost přijata
Děkujeme — náš tým vaši žádost posoudí a brzy se vám ozve.