Hotell-API
Sök bland 1.5M+ boenden via stadskod (i IATA-stil, t.ex. DXB) eller via hotellkoderna du sparar från vår katalog, läs priser på rumsnivå med kosttyp och avbokningsvillkor, validera och boka, och avboka enligt villkoren.
Sökning
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 hela resultatmängden; med wait=false ett searchId att polla med GET /v1/hotels/search/{searchId} – skicka samma datum och antal rum så att prisnycklarna förblir bokningsbara. Varje hotell har sitt innehåll (namn, stjärnor, adress, geoposition, huvudbild, faciliteter) och det billigaste priset per rum med en ogenomskinlig rateKey, total- och nattpris, måltidsupplägg, återbetalningsbarhet och sista avbokningsdag.
Rum och priser
GET /v1/hotels/{hotelCode}/rooms?rateKey=… listar alla rumstyper och priser för ett boende under den sökta vistelsen: sängtyper, beläggning, måltidsupplägg, villkor, skatter och avgifter specificerade, och om priset är återbetalningsbart.
Priskontroll
POST /v1/hotels/rates/{rateKey}/check bekräftar att priset fortfarande går att boka och returnerar slutligt pris och villkor. Gör detta direkt före bokningen: en 409 price_changed eller rate_expired här är betydligt billigare än en misslyckad bokning.
Boka
POST /v1/hotels/bookings med rateKey, bokningsinnehavaren, gäster per rum och en kontakt, plus en Idempotency-Key. Svaret är bokningen med dess referens, leverantörens bekräftelse och voucherdata. GET /v1/hotels/bookings/{bookingId} returnerar den igen när som helst.
Avboka
GET /v1/hotels/bookings/{bookingId}/cancellation-quote returnerar avgiften enligt villkoren just nu; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key krävs) genomför avbokningen.