Hotel-API
Søg blandt 1.5M+ overnatningssteder efter bykode (i IATA-stil, f.eks. DXB) eller efter de hotelkoder, du gemmer fra vores katalog, se priser på værelsesniveau med forplejning og afbestillingsbetingelser, validér og book, og afbestil i henhold til betingelserne.
Søgning
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 resultatsættet; med wait=false et searchId, som du poller med GET /v1/hotels/search/{searchId} — send de samme datoer og det samme antal værelser, så prisnøglerne forbliver bookbare. Hvert hotel har sit indhold (navn, stjerner, adresse, geodata, hovedbillede, faciliteter) og den billigste pris pr. værelse med et uigennemsigtigt rateKey, total- og pris pr. nat, forplejning, refunderbarhed og afbestillingsfrist.
Værelser og priser
GET /v1/hotels/{hotelCode}/rooms?rateKey=… viser alle værelsestyper og priser for ét overnatningssted for det søgte ophold: sengetyper, belægning, forplejning, betingelser, skatter og gebyrer specificeret, og om prisen kan refunderes.
Pristjek
POST /v1/hotels/rates/{rateKey}/check bekræfter, at prisen stadig kan bookes, og returnerer den endelige pris og de endelige betingelser. Gør det lige før booking: en 409 price_changed eller rate_expired her er langt billigere end en mislykket booking.
Book
POST /v1/hotels/bookings med rateKey, bookingindehaveren, gæster pr. værelse og kontaktoplysninger samt en Idempotency-Key. Svaret er bookingen med dens reference, leverandørens bekræftelse og voucherdata. GET /v1/hotels/bookings/{bookingId} returnerer den igen når som helst.
Afbestil
GET /v1/hotels/bookings/{bookingId}/cancellation-quote returnerer gebyret efter betingelserne på dette tidspunkt; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key påkrævet) gennemfører afbestillingen.