Szállás-API
Keressen 1.5M+ szálláshely között városkód (IATA-szerű, pl. DXB) vagy a katalógusunkból eltárolt szállodakódok alapján, olvassa ki a szobaszintű árakat az ellátással és a lemondási feltételekkel, ellenőrizzen és foglaljon, majd mondjon le a feltételek szerint.
Keresés
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.
wait=true esetén a teljes eredményhalmazt kapja; wait=false esetén egy searchId-t, amelyet a GET /v1/hotels/search/{searchId} végponttal kérdezhet le — adja meg ugyanazokat a dátumokat és szobaszámot, hogy az árkulcsok foglalhatók maradjanak. Minden szálloda tartalmazza a tartalmát (név, csillagok, cím, geo, fő kép, szolgáltatások) és szobánként a legolcsóbb árat egy átlátszatlan rateKey-jel, a teljes és éjszakánkénti árakat, az ellátást, a visszatéríthetőséget és a lemondási határidőt.
Szobák és árak
A GET /v1/hotels/{hotelCode}/rooms?rateKey=… felsorolja egy szálláshely összes szobatípusát és árát a keresett tartózkodásra: ágytípusok, férőhely, ellátás, feltételek, tételesen bontott adók és díjak, valamint hogy az ár visszatéríthető-e.
Árellenőrzés
A POST /v1/hotels/rates/{rateKey}/check megerősíti, hogy az ár még foglalható, és visszaadja a végső árat és feltételeket. Ezt közvetlenül a foglalás előtt tegye meg: egy itt kapott 409 price_changed vagy rate_expired sokkal olcsóbb, mint egy sikertelen foglalás.
Foglalás
POST /v1/hotels/bookings a rateKey-jel, a foglaló személlyel, szobánkénti vendégekkel és egy kapcsolattartóval, valamint Idempotency-Key fejléccel. A válasz a foglalás a hivatkozási számával, a beszállítói visszaigazolással és a voucheradatokkal. A GET /v1/hotels/bookings/{bookingId} bármikor újra visszaadja.
Lemondás
A GET /v1/hotels/bookings/{bookingId}/cancellation-quote visszaadja az adott pillanatban a feltételek szerint fizetendő kötbért; a POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key kötelező) véglegesíti.