API hotelowe
Przeszukuj 1.5M+ obiektów według kodu miasta (w stylu IATA, np. DXB) lub według kodów hoteli zapisanych z naszego katalogu, odczytuj stawki na poziomie pokoju z rodzajem wyżywienia i warunkami anulowania, weryfikuj i rezerwuj, anuluj zgodnie z warunkami.
Wyszukiwanie
POST /v1/hotels/search with a destination and check-in/out dates and one to eight rooms (adults and child ages per room). The destination is a cityCode (IATA-style, e.g. "DXB" — GET /v1/content/cities lists them), a list of hotelCodes from the catalogue you store on your side (GET /v1/content/hotels per city), or a geo circle. Name matching is yours to do against your stored list; availability is always asked by code.
Z wait=true otrzymujesz pełny zestaw wyników; z wait=false — searchId do odpytywania przez GET /v1/hotels/search/{searchId}: przekazuj te same daty i liczbę pokoi, aby klucze stawek pozostały dostępne do rezerwacji. Każdy hotel zawiera swoje treści (nazwa, gwiazdki, adres, lokalizacja, zdjęcie główne, udogodnienia) oraz najtańszą stawkę za pokój z nieprzezroczystym rateKey, ceną łączną i za noc, wyżywieniem, możliwością zwrotu i terminem bezpłatnego anulowania.
Pokoje i stawki
GET /v1/hotels/{hotelCode}/rooms?rateKey=… wymienia wszystkie typy pokoi i stawki jednego obiektu dla wyszukanego pobytu: rodzaje łóżek, liczbę osób, wyżywienie, zasady, podatki i opłaty w rozbiciu oraz informację, czy stawka jest zwrotna.
Weryfikacja stawki
POST /v1/hotels/rates/{rateKey}/check potwierdza, że stawka jest nadal dostępna do rezerwacji, i zwraca ostateczną cenę i zasady. Rób to tuż przed rezerwacją: 409 price_changed lub rate_expired na tym etapie kosztuje znacznie mniej niż nieudana rezerwacja.
Rezerwacja
POST /v1/hotels/bookings z rateKey, osobą rezerwującą, gośćmi w każdym pokoju i kontaktem oraz z Idempotency-Key. Odpowiedź to rezerwacja z jej numerem, potwierdzeniem dostawcy i danymi vouchera. GET /v1/hotels/bookings/{bookingId} zwraca ją ponownie w dowolnym momencie.
Anulowanie
GET /v1/hotels/bookings/{bookingId}/cancellation-quote zwraca karę zgodnie z zasadami na ten moment; POST /v1/hotels/bookings/{bookingId}/cancel (wymagany Idempotency-Key) zatwierdza anulowanie.