Locktrip
FirmyAI Agents
Integrace s AI agenty

Vytvořte AI agenty, kteří rezervují hotely

Propojte svého AI agenta s 2,5 miliony hotelů a apartmánů po celém světě pomocí Model Context Protocol (MCP). Vyhledávání je zdarma a nevyžaduje API klíč. Rezervujte jednoduchým REST voláním.

2.5M+

Hotely a apartmány

190+

Země

15

API nástroje

Zdarma

API pro vyhledávání

Jak to funguje

Tři kroky od vyhledávání po potvrzenou rezervaci. Váš AI agent programově zvládne celý proces.

1

Vyhledejte hotely

Použijte search_location k nalezení destinace, poté hotel_search pro dostupnost. Autentizace není potřeba. Filtrujte podle ceny, počtu hvězdiček, vybavení a typu stravování. Získejte podrobnosti o hotelu, fotografie a recenze.

2

Autentizace

Zavolejte guest_login s e-mailovou adresou pro získání Bearer tokenu. Pro hostovské účty není vyžadováno heslo. Použijte token pro všechny operace rezervace. Tokeny jsou standardní JWT platné pro autentizovaná API volání.

3

Rezervace a platba

Zavolejte prepare_booking s údaji o hostovi, poté dokončete platbu přes create_checkout (Revolut) nebo confirm_booking (B2B kreditní linka). Host automaticky obdrží potvrzovací e-mail.

Dostupné nástroje

15 nástrojů pokrývajících kompletní cyklus hotelové rezervace. Veřejné nástroje nevyžadují autentizaci. Autentizované nástroje vyžadují Bearer token z login nebo guest_login.

Veřejné nástroje (bez autentizace)

search_location

Vyhledávání měst, regionů a hotelů podle názvu. Vrací identifikátory lokací a souřadnice pro použití při vyhledávání hotelů.

hotel_search

Spuštění vyhledávání dostupnosti hotelů podle ID regionu nebo GPS souřadnic. Zadejte data, pokoje, národnost hosta a měnu.

get_search_results

Získání stránkovaných výsledků vyhledávání s filtry pro cenové rozpětí, počet hvězdiček, vybavení a typ stravování. Řazení podle ceny nebo hodnocení.

get_hotel_rooms

Získání dostupných pokojových balíčků pro konkrétní hotel. Vrací ceny, stravovací plány a identifikátory nabídek potřebné pro rezervaci.

check_cancellation_policy

Zobrazení lhůt pro stornování a penále za pokojové balíčky před rezervací.

get_hotel_details

Kompletní informace o hotelu: popis, vybavení, recenze, fotografie, souřadnice a blízké atrakce.

login

Autentizace pomocí e-mailu a hesla. Vrací Bearer token pro použití s autentizovanými nástroji.

guest_login

Registrace nebo přihlášení pouze s e-mailovou adresou. Heslo není vyžadováno. Vrací Bearer token pro rezervaci.

Autentizované nástroje (Bearer token)

prepare_booking

Vytvoření rezervace s údaji o hostovi a kontaktními informacemi. Vrací ID rezervace pro platbu. Rezervace vyprší po ~15 minutách.

confirm_booking

Potvrzení a platba přes B2B kreditní linku. Okamžité potvrzení s referenčním číslem rezervace. Pouze pro B2B partnery.

create_checkout

Vygenerování URL pro platbu přes Revolut. Přesměrujte koncového uživatele k platbě kartou. Rezervace se automaticky potvrdí prostřednictvím webhooku.

get_payment_url

Vygenerování Stripe URL pro platbu kartou. Alternativa k Revolutu pro trhy, kde je Stripe preferován.

list_bookings

Seznam rezervací filtrovaných podle stavu: nadcházející, dokončené, zrušené nebo čekající. Stránkované výsledky s informacemi o hotelu a datech.

get_booking_details

Kompletní detaily rezervace včetně informací o hotelu, jmen hostů, stavu platby a storno podmínek.

cancel_booking

Zrušení rezervace. Vrací výši refundace a případné storno poplatky. Vyžaduje explicitní příznak potvrzení.

Možnosti integrace

Zvolte protokol, který vyhovuje vašemu technologickému zásobníku. Všechny koncové body vrací stejná data. MCP klienti mohou automaticky objevit nástroje prostřednictvím koncového bodu pro objevování.

REST API

Volání nástrojů přímo přes HTTP POST. Každý nástroj má vlastní URL cestu. Odešlete JSON vstupní data v těle požadavku a obdržíte JSON odpověď. Veřejné nástroje nevyžadují hlavičky. Autentizované nástroje vyžadují hlavičku Authorization s Bearer tokenem.

# Search hotels in Paris (no auth)
curl -X POST \
  https://locktrip.com/mcp/tools/search_location \
  -H "Content-Type: application/json" \
  -d '{"query": "Paris"}'

# Book with auth token
curl -X POST \
  https://locktrip.com/mcp/tools/prepare_booking \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{ ... }'

MCP protokol

Použijte Model Context Protocol pro nativní integraci s AI agenty. Nástroje jsou automaticky objeveny prostřednictvím SSE nebo JSON-RPC. Kompatibilní s Claude Desktop, Cursor a jakýmkoli MCP-kompatibilním klientem. Koncový bod pro objevování poskytuje možnosti serveru a metadata nástrojů.

{
  "mcpServers": {
    "locktrip": {
      "url": "https://locktrip.com/mcp/sse"
    }
  }
}

Koncové body pro objevování

Strojově čitelné koncové body pro automatizované objevování nástrojů. Použijte je k integraci LockTripu do frameworků pro AI agenty, API bran nebo LLM registrů nástrojů.

Možnosti platby

Více platebních cest pro různé případy použití. B2C agenti generují platební odkazy pro koncové uživatele. B2B partneři platí okamžitě přes kreditní linku.

Platba přes Revolut

Vygenerujte hostovanou platební stránku pomocí nástroje create_checkout. Koncový uživatel klikne na odkaz a zaplatí kartou. Rezervace se automaticky potvrdí prostřednictvím webhooku. Nejlepší pro AI agenty zaměřené na spotřebitele.

Platba přes Stripe

Alternativní platba kartou přes nástroj get_payment_url. Vrací URL platební stránky hostované na Stripe. Užitečné pro trhy nebo měny, kde je Stripe preferován před Revolutem.

B2B kreditní linka

Pro obchodní partnery s předfinancovanou kreditní linkou. Zavolejte confirm_booking pro okamžitou platbu z vašeho zůstatku. Není potřeba přesměrování. Ideální pro cestovní kanceláře a OTA budující automatizované rezervační procesy.

Limity požadavků

Velkorysé limity pro anonymní i autentizované použití. Autentizovaní uživatelé získávají vyšší kvóty pro všechny koncové body.

ÚroveňVyhledávací nástrojeRezervační nástroje
Anonymní30 požadavků/minN/A (vyžaduje autentizaci)
Autentizovaný60 požadavků/min20 požadavků/min

Připraveni začít?

Začněte vyhledávat hotely hned teď bez API klíče. Přečtěte si OpenAPI specifikaci nebo připojte svého MCP klienta pro automatické objevení všech 15 nástrojů. Pro B2B partnerství a přístup ke kreditní lince, kontaktujte náš obchodní tým.