Hotel-API
Durchsuchen Sie 1.5M+ Unterkünfte nach Städtecode (im IATA-Stil, z. B. DXB) oder nach den Hotelcodes, die Sie aus unserem Katalog speichern, lesen Sie Raten auf Zimmerebene mit Verpflegungsart und Stornobedingungen, validieren und buchen Sie, und stornieren Sie gemäß den Bedingungen.
Suche
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.
Mit wait=true erhalten Sie die vollständige Ergebnismenge; mit wait=false eine searchId, die Sie mit GET /v1/hotels/search/{searchId} abfragen – übergeben Sie dieselben Daten und dieselbe Zimmeranzahl, damit die Raten-Schlüssel buchbar bleiben. Jedes Hotel enthält seine Inhalte (Name, Sterne, Adresse, Geodaten, Titelbild, Ausstattung) und die günstigste Rate pro Zimmer mit einem undurchsichtigen rateKey, dem Gesamt- und Nachtpreis, der Verpflegung, der Erstattbarkeit und der Stornofrist.
Zimmer und Raten
GET /v1/hotels/{hotelCode}/rooms?rateKey=… listet alle Zimmertypen und Raten einer Unterkunft für den gesuchten Aufenthalt: Bettenarten, Belegung, Verpflegung, Bedingungen, Steuern und Gebühren einzeln ausgewiesen sowie ob die Rate erstattbar ist.
Ratenprüfung
POST /v1/hotels/rates/{rateKey}/check bestätigt, dass die Rate noch buchbar ist, und liefert den endgültigen Preis und die Bedingungen. Führen Sie dies unmittelbar vor der Buchung aus: Ein 409 price_changed oder rate_expired an dieser Stelle ist weit günstiger als eine fehlgeschlagene Buchung.
Buchen
POST /v1/hotels/bookings mit dem rateKey, dem Buchungsinhaber, den Gästen pro Zimmer und einem Kontakt, dazu ein Idempotency-Key. Die Antwort ist die Buchung mit ihrer Referenz, der Bestätigung des Anbieters und den Voucher-Daten. GET /v1/hotels/bookings/{bookingId} liefert sie jederzeit erneut.
Stornieren
GET /v1/hotels/bookings/{bookingId}/cancellation-quote liefert die zum aktuellen Zeitpunkt nach den Bedingungen anfallende Gebühr; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key erforderlich) führt die Stornierung verbindlich aus.