Hotelové API
Vyhľadávajte v 1.5M+ ubytovacích zariadeniach podľa kódu mesta (v štýle IATA, napr. DXB) alebo podľa kódov hotelov, ktoré si uložíte z nášho katalógu, čítajte ceny na úrovni izieb vrátane typu stravovania a storno podmienok, overte a rezervujte, rušte podľa podmienok.
Vyhľadávanie
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 úplnú sadu výsledkov; s wait=false searchId na dopytovanie cez GET /v1/hotels/search/{searchId} — posielajte rovnaké dátumy a počet izieb, aby kľúče sadzieb zostali rezervovateľné. Každý hotel obsahuje svoj obsah (názov, hviezdičky, adresa, geolokácia, hlavný obrázok, vybavenie) a najlacnejšiu sadzbu na izbu s neprehľadným rateKey, celkovou a nočnou cenou, typom stravovania, možnosťou refundácie a termínom bezplatného zrušenia.
Izby a sadzby
GET /v1/hotels/{hotelCode}/rooms?rateKey=… zobrazí všetky typy izieb a sadzby jedného ubytovania pre hľadaný pobyt: typy postelí, obsadenosť, stravovanie, podmienky, dane a poplatky v rozpise a či je sadzba refundovateľná.
Kontrola sadzby
POST /v1/hotels/rates/{rateKey}/check potvrdí, že sadzba je stále rezervovateľná, a vráti konečnú cenu a podmienky. Urobte to tesne pred rezerváciou: 409 price_changed alebo rate_expired v tomto kroku je oveľa lacnejšie než neúspešná rezervácia.
Rezervácia
POST /v1/hotels/bookings s rateKey, držiteľom rezervácie, hosťami pre každú izbu a kontaktom, plus Idempotency-Key. Odpoveďou je rezervácia s jej referenciou, potvrdením dodávateľa a údajmi poukazu. GET /v1/hotels/bookings/{bookingId} ju kedykoľvek vráti znova.
Zrušenie
GET /v1/hotels/bookings/{bookingId}/cancellation-quote vráti storno poplatok podľa podmienok v danom okamihu; POST /v1/hotels/bookings/{bookingId}/cancel (vyžaduje Idempotency-Key) zrušenie potvrdí.