Twórz AI Agentów Rezerwujących Hotele
Połącz swojego AI agenta z 2,5 miliona hoteli i apartamentów na całym świecie, korzystając z Model Context Protocol (MCP). Wyszukiwanie jest bezpłatne i nie wymaga API key. Rezerwuj prostym wywołaniem REST.
2.5M+
Hotele i Apartamenty
190+
Kraje
15
Narzędzia API
Bezpłatnie
API Wyszukiwania
Jak to Działa
Trzy kroki od wyszukiwania do potwierdzonej rezerwacji. Twój AI agent obsługuje cały proces programowo.
Wyszukaj Hotele
Użyj search_location, aby znaleźć destynację, a następnie hotel_search, aby sprawdzić dostępność. Bez konieczności uwierzytelniania. Filtruj według ceny, gwiazdek, udogodnień i typu wyżywienia. Uzyskaj szczegóły hotelu, zdjęcia i opinie.
Uwierzytelnij się
Wywołaj guest_login z adresem e-mail, aby uzyskać token Bearer. Hasło nie jest wymagane dla kont gościnnych. Użyj tokenu do wszystkich operacji rezerwacyjnych. Tokeny to standardowe JWT ważne dla uwierzytelnionych wywołań API.
Zarezerwuj i Zapłać
Wywołaj prepare_booking z danymi gościa, a następnie sfinalizuj płatność przez create_checkout (Revolut) lub confirm_booking (linia kredytowa B2B). Gość automatycznie otrzymuje e-mail z potwierdzeniem.
Dostępne Narzędzia
15 narzędzi obejmujących pełny cykl rezerwacji hotelowych. Publiczne narzędzia nie wymagają uwierzytelniania. Narzędzia uwierzytelnione wymagają tokenu Bearer z login lub guest_login.
Narzędzia Publiczne (Bez Uwierzytelniania)
search_location
Wyszukaj miasta, regiony i hotele po nazwie. Zwraca ID lokalizacji i współrzędne do wykorzystania w wyszukiwaniu hoteli.
hotel_search
Rozpocznij wyszukiwanie dostępności hoteli według ID regionu lub współrzędnych GPS. Określ daty, pokoje, narodowość gościa i walutę.
get_search_results
Pobierz paginowane wyniki wyszukiwania z filtrami zakresu cen, gwiazdek, udogodnień i typu wyżywienia. Sortuj według ceny lub oceny.
get_hotel_rooms
Pobierz dostępne pakiety pokoi dla konkretnego hotelu. Zwraca ceny, plany wyżywienia i ID wycen potrzebne do rezerwacji.
check_cancellation_policy
Sprawdź terminy anulowania i opłaty karne dla pakietów pokoi przed rezerwacją.
get_hotel_details
Pobierz pełne informacje o hotelu: opis, udogodnienia, opinie, zdjęcia, współrzędne i pobliskie atrakcje.
login
Uwierzytelnij się za pomocą e-maila i hasła. Zwraca token Bearer do użycia z narzędziami uwierzytelnionymi.
guest_login
Zarejestruj się lub zaloguj tylko adresem e-mail. Hasło nie jest wymagane. Zwraca token Bearer do rezerwacji.
Narzędzia Uwierzytelnione (Token Bearer)
prepare_booking
Utwórz rezerwację z danymi gościa i informacjami kontaktowymi. Zwraca ID rezerwacji do płatności. Rezerwacje wygasają po ok. 15 minutach.
confirm_booking
Potwierdź i zapłać za pomocą linii kredytowej B2B. Natychmiastowe potwierdzenie z numerem referencyjnym rezerwacji. Tylko dla partnerów B2B.
create_checkout
Wygeneruj URL płatności Revolut. Przekieruj użytkownika końcowego do zapłaty kartą. Rezerwacja jest potwierdzana automatycznie przez webhook.
get_payment_url
Wygeneruj URL checkout Stripe do płatności kartą. Alternatywa dla Revolut na rynkach, gdzie Stripe jest preferowany.
list_bookings
Lista rezerwacji filtrowanych według statusu: nadchodzące, zakończone, anulowane lub oczekujące. Paginowane wyniki z informacjami o hotelu i datach.
get_booking_details
Pobierz pełne szczegóły rezerwacji, w tym informacje o hotelu, nazwiska gości, status płatności i politykę anulowania.
cancel_booking
Anuluj rezerwację. Zwraca kwotę zwrotu i ewentualne opłaty za anulowanie. Wymaga jawnej flagi potwierdzenia.
Opcje Integracji
Wybierz protokół odpowiedni dla Twojego stacku. Wszystkie endpointy zwracają te same dane. Klienci MCP mogą automatycznie odkrywać narzędzia przez endpoint odkrywania.
REST API
Wywołuj narzędzia bezpośrednio przez HTTP POST. Każde narzędzie ma własną ścieżkę URL. Wyślij dane wejściowe JSON w treści żądania i otrzymaj dane wyjściowe JSON. Publiczne narzędzia nie wymagają nagłówków. Narzędzia uwierzytelnione wymagają nagłówka Authorization z tokenem Bearer.
# 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 '{ ... }'Protokół MCP
Użyj Model Context Protocol do natywnej integracji z AI agentami. Narzędzia są automatycznie wykrywane przez SSE lub JSON-RPC. Kompatybilny z Claude Desktop, Cursor i każdym klientem zgodnym z MCP. Endpoint odkrywania udostępnia możliwości serwera i metadane narzędzi.
{
"mcpServers": {
"locktrip": {
"url": "https://locktrip.com/mcp/sse"
}
}
}Endpointy Odkrywania
Endpointy czytelne maszynowo do automatycznego odkrywania narzędzi. Użyj ich do integracji LockTrip z frameworkami AI agentów, bramkami API lub rejestrami narzędzi LLM.
Opcje Płatności
Wiele ścieżek płatności dla różnych przypadków użycia. Agenci B2C generują linki do checkout dla użytkowników końcowych. Partnerzy B2B płacą natychmiast przez linię kredytową.
Checkout Revolut
Wygeneruj hostowaną stronę płatności za pomocą narzędzia create_checkout. Użytkownik końcowy klika link i płaci kartą. Rezerwacja jest automatycznie potwierdzana przez webhook. Idealne dla AI agentów skierowanych do konsumentów.
Checkout Stripe
Alternatywna płatność kartą przez narzędzie get_payment_url. Zwraca URL checkout hostowany przez Stripe. Przydatne na rynkach lub dla walut, gdzie Stripe jest preferowany nad Revolut.
Linia Kredytowa B2B
Dla partnerów biznesowych z przedpłaconą linią kredytową. Wywołaj confirm_booking, aby zapłacić natychmiast z salda. Bez przekierowania. Idealne dla biur podróży i OTA budujących zautomatyzowane procesy rezerwacji.
Limity Żądań
Hojne limity zarówno dla anonimowego, jak i uwierzytelnionego użycia. Uwierzytelnieni użytkownicy otrzymują wyższe limity na wszystkich endpointach.
| Poziom | Narzędzia Wyszukiwania | Narzędzia Rezerwacji |
|---|---|---|
| Anonimowy | 30 żąd./min | Nie dot. (wymagane uwierzytelnienie) |
| Uwierzytelniony | 60 żąd./min | 20 żąd./min |
Gotowy do Budowania?
Zacznij wyszukiwać hotele już teraz bez API key. Przeczytaj specyfikację OpenAPI lub podłącz swojego klienta MCP, aby automatycznie odkryć wszystkie 15 narzędzi. W sprawie partnerstw B2B i dostępu do linii kredytowej, skontaktuj się z naszym zespołem biznesowym.