Hotelové API
Vyhledávejte v 1.5M+ ubytováních podle kódu města (ve stylu IATA, např. DXB) nebo podle kódů hotelů, které si uložíte z našeho katalogu, čtěte ceny na úrovni pokojů včetně typu stravování a storno podmínek, ověřte a rezervujte, rušte podle podmínek.
Vyhledávání
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.
S wait=true dostanete celou sadu výsledků; s wait=false searchId, se kterým se dotazujete přes GET /v1/hotels/search/{searchId} — posílejte stejná data a počet pokojů, aby klíče cen zůstaly rezervovatelné. Každý hotel nese svůj obsah (název, hvězdičky, adresa, poloha, hlavní obrázek, vybavení) a nejlevnější cenu za pokoj s neprůhledným rateKey, celkovou a noční cenou, typem stravování, vratností a lhůtou pro bezplatné storno.
Pokoje a ceny
GET /v1/hotels/{hotelCode}/rooms?rateKey=… uvádí všechny typy pokojů a ceny jednoho ubytování pro vyhledaný pobyt: typy lůžek, obsazenost, stravování, podmínky, rozepsané daně a poplatky a zda je cena vratná.
Kontrola ceny
POST /v1/hotels/rates/{rateKey}/check potvrdí, že cenu lze stále rezervovat, a vrátí konečnou cenu a podmínky. Proveďte to bezprostředně před rezervací: 409 price_changed nebo rate_expired v tomto kroku je mnohem levnější než neúspěšná rezervace.
Rezervace
POST /v1/hotels/bookings s rateKey, držitelem rezervace, hosty v každém pokoji a kontaktem, plus Idempotency-Key. Odpovědí je rezervace s referencí, potvrzením dodavatele a údaji voucheru. GET /v1/hotels/bookings/{bookingId} ji kdykoli vrátí znovu.
Storno
GET /v1/hotels/bookings/{bookingId}/cancellation-quote vrací storno poplatek podle podmínek platných v danou chvíli; POST /v1/hotels/bookings/{bookingId}/cancel (vyžaduje Idempotency-Key) storno provede.