API Hotel
Cerca tra 1.5M+ strutture per codice città (in stile IATA, ad es. DXB) o per i codici hotel che memorizzi dal nostro catalogo, leggi le tariffe a livello di camera con trattamento e politica di cancellazione, verifica e prenota, cancella secondo la politica.
Ricerca
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.
Con wait=true ottieni l'insieme completo dei risultati; con wait=false un searchId su cui eseguire il polling con GET /v1/hotels/search/{searchId}: passa le stesse date e lo stesso numero di camere perché le chiavi tariffa restino prenotabili. Ogni hotel contiene i propri contenuti (nome, stelle, indirizzo, coordinate, immagine principale, servizi) e la tariffa più economica per camera con un rateKey opaco, il totale e i prezzi per notte, il trattamento, la rimborsabilità e il termine di cancellazione.
Camere e tariffe
GET /v1/hotels/{hotelCode}/rooms?rateKey=… elenca ogni tipo di camera e tariffa di una struttura per il soggiorno cercato: tipi di letto, occupazione, trattamento, politiche, tasse e oneri dettagliati, e se la tariffa è rimborsabile.
Verifica della tariffa
POST /v1/hotels/rates/{rateKey}/check conferma che la tariffa è ancora prenotabile e restituisce il prezzo e la politica definitivi. Fallo subito prima di prenotare: un 409 price_changed o rate_expired in questa fase costa molto meno di una prenotazione fallita.
Prenota
POST /v1/hotels/bookings con il rateKey, il titolare, gli ospiti per camera e un contatto, più una Idempotency-Key. La risposta è la prenotazione con il suo riferimento, la conferma del fornitore e i dati del voucher. GET /v1/hotels/bookings/{bookingId} la restituisce di nuovo in qualsiasi momento.
Cancella
GET /v1/hotels/bookings/{bookingId}/cancellation-quote restituisce la penale prevista dalla politica in questo momento; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key obbligatoria) conferma la cancellazione.