Vyzkoušet zdarma
API pro vývojáře

Živé 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 pravidel jednotlivých evropských zemí přímo ve svém produktu.

Proč integrovat Best Guest

Vaši zákazníci působící napříč Evropou potřebují registraci hostů, hlášení místním úřadům a soulad s místním poplatkem z pobytu — a pravidla se v každé zemi liší. 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

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í místním úřadům

Hlášení hostů podávaná místním úřadům jménem vašich zákazníků — automatizovaná tam, kde existuje oficiální systém (UbyPort v Česku běží v ostrém provozu), jinde formou připravených dokumentů k podání tam, kde veřejné API zatím neexistuje.

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.

API pro vývojáře

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í.

Odesláním souhlasíte, že vás Best Guest může kontaktovat ohledně partnerství. Podrobnosti najdete v Zásadách ochrany osobních údajů.