Hotellirajapinta
Hae 1.5M+ majoituskohdetta kaupunkikoodilla (IATA-tyylinen, esim. DXB) tai luettelostamme tallentamillasi hotellikoodeilla, lue huonekohtaiset hinnat ateriapaketteineen ja peruutusehtoineen, vahvista ja varaa sekä peru ehtojen mukaisesti.
Haku
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.
Kun wait=true, saat koko tulosjoukon; kun wait=false, saat searchId:n, jota kyselet kutsulla GET /v1/hotels/search/{searchId} – anna samat päivämäärät ja huonemäärä, jotta hinta-avaimet pysyvät varattavina. Jokaisella hotellilla on sisältönsä (nimi, tähdet, osoite, sijainti, pääkuva, palvelut) sekä huonekohtainen halvin hinta läpinäkymättömän rateKey-arvon kera, kokonais- ja yökohtaiset hinnat, ateriapaketti, hyvitettävyys ja peruutuksen määräaika.
Huoneet ja hinnat
GET /v1/hotels/{hotelCode}/rooms?rateKey=… listaa yhden kohteen kaikki huonetyypit ja hinnat haetulle oleskelulle: sänkytyypit, henkilömäärä, ateriapaketti, ehdot, verot ja maksut eriteltyinä sekä tieto siitä, onko hinta hyvitettävissä.
Hinnan tarkistus
POST /v1/hotels/rates/{rateKey}/check vahvistaa, että hinta on yhä varattavissa, ja palauttaa lopullisen hinnan ja ehdot. Tee tämä juuri ennen varaamista: 409 price_changed tai rate_expired tässä vaiheessa tulee paljon halvemmaksi kuin epäonnistunut varaus.
Varaa
POST /v1/hotels/bookings, jossa rateKey, varaaja, vieraat huoneittain ja yhteystiedot sekä Idempotency-Key. Vastauksena saat varauksen viitteineen, toimittajan vahvistuksen ja voucherin tiedot. GET /v1/hotels/bookings/{bookingId} palauttaa sen uudelleen milloin tahansa.
Peruuta
GET /v1/hotels/bookings/{bookingId}/cancellation-quote palauttaa ehtojen mukaisen peruutusmaksun tällä hetkellä; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key pakollinen) vahvistaa peruutuksen.