API hoteluri
Caută printre 1.5M+ de proprietăți după codul orașului (în stil IATA, de ex. DXB) sau după codurile de hotel pe care le păstrezi din catalogul nostru, citește tarifele la nivel de cameră cu tipul de masă și politica de anulare, validează și rezervă, anulează conform politicii.
Căutare
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.
Cu wait=true primești setul complet de rezultate; cu wait=false, un searchId de interogat cu GET /v1/hotels/search/{searchId} — trimite aceleași date și același număr de camere, ca cheile de tarif să rămână rezervabile. Fiecare hotel conține conținutul său (nume, stele, adresă, coordonate, imagine principală, facilități) și cel mai ieftin tarif pe cameră, cu un rateKey opac, prețul total și pe noapte, regimul de masă, posibilitatea de rambursare și termenul-limită de anulare.
Camere și tarife
GET /v1/hotels/{hotelCode}/rooms?rateKey=… listează toate tipurile de camere și tarifele unei unități pentru șederea căutată: tipuri de pat, ocupare, regim de masă, politici, taxe și comisioane detaliate și dacă tariful este rambursabil.
Verificarea tarifului
POST /v1/hotels/rates/{rateKey}/check confirmă că tariful este încă rezervabil și întoarce prețul și politica finale. Fă asta imediat înainte de rezervare: un 409 price_changed sau rate_expired aici costă mult mai puțin decât o rezervare eșuată.
Rezervare
POST /v1/hotels/bookings cu rateKey, titularul, oaspeții pe cameră și datele de contact, plus un Idempotency-Key. Răspunsul este rezervarea cu referința sa, confirmarea furnizorului și datele voucherului. GET /v1/hotels/bookings/{bookingId} o întoarce din nou oricând.
Anulare
GET /v1/hotels/bookings/{bookingId}/cancellation-quote întoarce penalitatea conform politicii în acest moment; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key obligatoriu) confirmă anularea.