Izgradite AI agente koji rezerviraju hotele
Povežite svog AI agenta s 2,5 milijuna hotala i apartmana diljem svijeta koristeći Model Context Protocol (MCP). Pretraživanje je besplatno i ne zahtijeva API ključ. Rezervirajte jednostavnim REST pozivom.
2.5M+
Hoteli i apartmani
190+
Države
15
API alati
Besplatno
API za pretraživanje
Kako funkcionira
Tri koraka od pretrage do potvrđene rezervacije. Vaš AI agent upravlja cijelim procesom programski.
Pretraži hotele
Koristite search_location za pronalaženje destinacije, zatim hotel_search za provjeru dostupnosti. Autentifikacija nije potrebna. Filtrirajte po cijeni, zvjezdicama, pogodnostima i vrsti obroka. Dobijte detalje o hotelu, fotografije i recenzije.
Autentifikacija
Pozovite guest_login s email adresom za dobivanje Bearer tokena. Lozinka nije potrebna za gostujuće račune. Koristite token za sve operacije rezervacije. Tokeni su standardni JWT, valjani za autentificirane API pozive.
Rezerviraj i plati
Pozovite prepare_booking s podacima gostiju, zatim dovršite plaćanje putem create_checkout (Revolut) ili confirm_booking (B2B kreditna linija). Gost automatski prima email s potvrdom.
Dostupni alati
15 alata koji pokrivaju potpuni životni ciklus hotelske rezervacije. Javni alati ne zahtijevaju autentifikaciju. Autentificirani alati zahtijevaju Bearer token od login ili guest_login.
Javni alati (bez autentifikacije)
search_location
Pretraživanje gradova, regija i hotela po imenu. Vraća ID-ove lokacija i koordinate za korištenje u pretrazi hotela.
hotel_search
Pokrenite pretragu dostupnosti hotela po ID-u regije ili GPS koordinatama. Navedite datume, sobe, nacionalnost gosta i valutu.
get_search_results
Dohvatite paginirane rezultate pretrage s filterima za raspon cijena, zvjezdice, pogodnosti i vrstu obroka. Sortiranje po cijeni ili ocjeni.
get_hotel_rooms
Dohvatite dostupne pakete soba za određeni hotel. Vraća cijene, planove obroka i quoteIds potrebne za rezervaciju.
check_cancellation_policy
Pregledajte rokove otkazivanja i penale za pakete soba prije rezervacije.
get_hotel_details
Potpune informacije o hotelu: opis, pogodnosti, recenzije, fotografije, koordinate i obližnje atrakcije.
login
Autentifikacija s emailom i lozinkom. Vraća Bearer token za korištenje s autentificiranim alatima.
guest_login
Registracija ili prijava samo s email adresom. Lozinka nije potrebna. Vraća Bearer token za rezervaciju.
Autentificirani alati (Bearer token)
prepare_booking
Kreiranje rezervacije s podacima gostiju i kontakt informacijama. Vraća ID rezervacije za plaćanje. Rezervacije istječu nakon ~15 minuta.
confirm_booking
Potvrda i plaćanje putem B2B kreditne linije. Trenutna potvrda s referentnim brojem rezervacije. Samo za B2B partnere.
create_checkout
Generiranje Revolut URL-a za plaćanje. Preusmjerite krajnjeg korisnika za plaćanje karticom. Rezervacija se automatski potvrđuje putem webhook-a.
get_payment_url
Generiranje Stripe URL-a za plaćanje karticom. Alternativa Revolutu za tržišta gdje je Stripe preferiran.
list_bookings
Popis rezervacija filtriranih po statusu: nadolazeće, završene, otkazane ili na čekanju. Paginirani rezultati s informacijama o hotelu i datumima.
get_booking_details
Potpuni detalji rezervacije uključujući informacije o hotelu, imena gostiju, status plaćanja i politiku otkazivanja.
cancel_booking
Otkazivanje rezervacije. Vraća iznos povrata i naknade za otkazivanje. Zahtijeva eksplicitnu potvrdu.
Opcije integracije
Odaberite protokol koji odgovara vašem stacku. Sve krajnje točke vraćaju iste podatke. MCP klijenti mogu automatski otkriti alate putem krajnje točke za otkrivanje.
REST API
Pozivajte alate izravno putem HTTP POST. Svaki alat ima vlastiti URL put. Pošaljite JSON ulaz u tijelu zahtjeva i primite JSON izlaz. Javni alati ne zahtijevaju zaglavlja. Autentificirani alati zahtijevaju Authorization zaglavlje s Bearer tokenom.
# 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
Koristite Model Context Protocol za nativnu integraciju AI agenata. Alati se automatski otkrivaju putem SSE ili JSON-RPC. Kompatibilan s Claude Desktop, Cursor i bilo kojim MCP-kompatibilnim klijentom. Krajnja točka za otkrivanje pruža mogućnosti servera i metapodatke alata.
{
"mcpServers": {
"locktrip": {
"url": "https://locktrip.com/mcp/sse"
}
}
}Krajnje točke za otkrivanje
Strojno čitljive krajnje točke za automatizirano otkrivanje alata. Koristite ih za integraciju LockTripa u okvire AI agenata, API gatewaye ili registre LLM alata.
Opcije plaćanja
Više putova plaćanja za različite slučajeve korištenja. B2C agenti generiraju linkove za plaćanje za krajnje korisnike. B2B partneri plaćaju trenutno putem kreditne linije.
Revolut plaćanje
Generirajte hostanu stranicu za plaćanje putem alata create_checkout. Krajnji korisnik klikne link i plati karticom. Rezervacija se automatski potvrđuje putem webhook-a. Najbolje za AI agente usmjerene prema potrošačima.
Stripe plaćanje
Alternativno plaćanje karticom putem alata get_payment_url. Vraća Stripe hostani URL za plaćanje. Korisno za tržišta ili valute gdje je Stripe preferiran nad Revolutom.
B2B kreditna linija
Za poslovne partnere s prethodno financiranom kreditnom linijom. Pozovite confirm_booking za trenutno plaćanje s vašeg salda. Preusmjeravanje nije potrebno. Idealno za putničke agencije i OTA-e koji grade automatizirane procese rezervacije.
Ograničenja zahtjeva
Velikodušna ograničenja za anonimnu i autentificiranu upotrebu. Autentificirani korisnici dobivaju veće kvote za sve krajnje točke.
| Razina | Alati za pretraživanje | Alati za rezervaciju |
|---|---|---|
| Anonimni | 30 req/min | N/A (potrebna autentifikacija) |
| Autentificirani | 60 req/min | 20 req/min |
Spremni za izgradnju?
Počnite pretraživati hotele odmah bez API ključa. Pročitajte OpenAPI specifikaciju ili povežite svoj MCP klijent za automatsko otkrivanje svih 15 alata. Za B2B partnerstva i pristup kreditnoj liniji, kontaktirajte naš poslovni tim.