API pro vývojáře

Soukromé API pro partnerské integrace

Best Guest připravuje API, díky kterému budou moci 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.

API Best Guest je aktuálně soukromé a dostupné pouze vybraným partnerům na základě smlouvy. Není určeno pro veřejný samoobslužný přístup.

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.

API pro vývojáře

Plánované možnosti

Rozsah, na kterém s partnery pracujeme. Dostupnost a finální podoba závisí na konkrétní partnerské smlouvě.

📅

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.

Ilustrativní 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://app.bestguestapp.com/..."
  }
}

Pouze ilustrativní ukázka — finální schéma se může lišit. Přístup je možný pouze na základě partnerské smlouvy.

Žádost o přístup k API

Řekněte nám o svém produktu a ozveme se vám ohledně partnerství.