API za hotele
Pretražujte 1.5M+ objekata po kodu grada (u IATA stilu, npr. DXB) ili po kodovima hotela koje pohranite iz našeg kataloga, čitajte cijene na razini soba s uslugom prehrane i uvjetima otkazivanja, provjerite i rezervirajte te otkažite u skladu s uvjetima.
Pretraživanje
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.
Uz wait=true dobivate cijeli skup rezultata; uz wait=false searchId za periodičke provjere s GET /v1/hotels/search/{searchId} — pošaljite iste datume i broj soba kako bi ključevi cijena ostali rezervabilni. Svaki hotel nosi svoj sadržaj (naziv, zvjezdice, adresu, geolokaciju, glavnu sliku, sadržaje) i najjeftiniju cijenu po sobi s neprozirnim rateKey, ukupnom i noćnom cijenom, vrstom usluge, mogućnošću povrata i rokom za otkazivanje.
Sobe i cijene
GET /v1/hotels/{hotelCode}/rooms?rateKey=… navodi sve vrste soba i cijene jednog objekta za traženi boravak: vrste kreveta, popunjenost, uslugu, pravila, raščlanjene pristojbe i naknade te je li cijena povratna.
Provjera cijene
POST /v1/hotels/rates/{rateKey}/check potvrđuje da je cijena još rezervabilna i vraća konačnu cijenu i pravila. Učinite to neposredno prije rezervacije: 409 price_changed ili rate_expired ovdje je daleko jeftiniji od neuspjele rezervacije.
Rezervacija
POST /v1/hotels/bookings s rateKey, nositeljem rezervacije, gostima po sobi i kontaktom, uz Idempotency-Key. Odgovor je rezervacija s referencom, potvrdom dobavljača i podacima vaučera. GET /v1/hotels/bookings/{bookingId} vraća je ponovno u bilo kojem trenutku.
Otkazivanje
GET /v1/hotels/bookings/{bookingId}/cancellation-quote vraća penal prema pravilima u tom trenutku; POST /v1/hotels/bookings/{bookingId}/cancel (obavezan Idempotency-Key) ga provodi.