API ξενοδοχείων
Αναζητήστε 1.5M+ καταλύματα με κωδικό πόλης (τύπου IATA, π.χ. DXB) ή με τους κωδικούς ξενοδοχείων που αποθηκεύετε από τον κατάλογό μας, διαβάστε τιμές ανά δωμάτιο με τύπο διατροφής και πολιτική ακύρωσης, επικυρώστε και κάντε κράτηση, ακυρώστε σύμφωνα με την πολιτική.
Αναζήτηση
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.
Με wait=true λαμβάνετε ολόκληρο το σύνολο αποτελεσμάτων· με wait=false ένα searchId για polling με GET /v1/hotels/search/{searchId} — περάστε τις ίδιες ημερομηνίες και τον ίδιο αριθμό δωματίων ώστε τα κλειδιά τιμών να παραμένουν διαθέσιμα για κράτηση. Κάθε ξενοδοχείο φέρει το περιεχόμενό του (όνομα, αστέρια, διεύθυνση, γεωγραφική θέση, κύρια εικόνα, παροχές) και τη φθηνότερη τιμή ανά δωμάτιο με ένα αδιαφανές rateKey, τη συνολική τιμή και τις τιμές ανά νύχτα, τη βάση διατροφής, τη δυνατότητα επιστροφής χρημάτων και την προθεσμία ακύρωσης.
Δωμάτια και τιμές
Το GET /v1/hotels/{hotelCode}/rooms?rateKey=… παραθέτει κάθε τύπο δωματίου και τιμή ενός καταλύματος για τη διαμονή που αναζητήθηκε: τύποι κρεβατιών, πληρότητα, διατροφή, πολιτικές, φόροι και τέλη αναλυτικά, και αν η τιμή επιστρέφεται.
Έλεγχος τιμής
Το POST /v1/hotels/rates/{rateKey}/check επιβεβαιώνει ότι η τιμή είναι ακόμη διαθέσιμη για κράτηση και επιστρέφει την τελική τιμή και την πολιτική. Κάντε το αμέσως πριν από την κράτηση: ένα 409 price_changed ή rate_expired σε αυτό το σημείο κοστίζει πολύ λιγότερο από μια αποτυχημένη κράτηση.
Κράτηση
POST /v1/hotels/bookings με το rateKey, τον κάτοχο, τους επισκέπτες ανά δωμάτιο και στοιχεία επικοινωνίας, συν ένα Idempotency-Key. Η απόκριση είναι η κράτηση με τον κωδικό αναφοράς της, την επιβεβαίωση του προμηθευτή και τα δεδομένα του voucher. Το GET /v1/hotels/bookings/{bookingId} την επιστρέφει ξανά οποιαδήποτε στιγμή.
Ακύρωση
Το GET /v1/hotels/bookings/{bookingId}/cancellation-quote επιστρέφει την ποινή σύμφωνα με την πολιτική τη δεδομένη στιγμή· το POST /v1/hotels/bookings/{bookingId}/cancel (απαιτείται Idempotency-Key) εκτελεί την ακύρωση.