Hotell-API
Søk blant 1.5M+ overnattingssteder etter bykode (i IATA-stil, f.eks. DXB) eller etter hotellkodene du lagrer fra katalogen vår, les priser på romnivå med måltidsplan og avbestillingsvilkår, valider og bestill, og avbestill i henhold til vilkårene.
Søk
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.
Med wait=true får du hele resultatsettet; med wait=false en searchId som du poller med GET /v1/hotels/search/{searchId} – send de samme datoene og samme antall rom, slik at prisnøklene forblir bestillbare. Hvert hotell har sitt innhold (navn, stjerner, adresse, geoposisjon, hovedbilde, fasiliteter) og den billigste prisen per rom med en ugjennomsiktig rateKey, total- og nattpriser, måltidsordning, om prisen kan refunderes, og kanselleringsfristen.
Rom og priser
GET /v1/hotels/{hotelCode}/rooms?rateKey=… lister alle romtyper og priser for ett overnattingssted for det søkte oppholdet: sengetyper, beleggskapasitet, måltider, vilkår, skatter og gebyrer spesifisert, og om prisen kan refunderes.
Priskontroll
POST /v1/hotels/rates/{rateKey}/check bekrefter at prisen fortsatt kan bestilles, og returnerer endelig pris og vilkår. Gjør dette rett før bestilling: en 409 price_changed eller rate_expired her er langt billigere enn en mislykket bestilling.
Bestill
POST /v1/hotels/bookings med rateKey, innehaveren, gjester per rom og en kontaktperson, pluss en Idempotency-Key. Svaret er bestillingen med referanse, leverandørens bekreftelse og kupongdata. GET /v1/hotels/bookings/{bookingId} returnerer den igjen når som helst.
Kanseller
GET /v1/hotels/bookings/{bookingId}/cancellation-quote returnerer gebyret etter vilkårene på det aktuelle tidspunktet; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key påkrevd) gjennomfører kanselleringen.