Otel API'si
1.5M+ tesisi şehir koduna (IATA tarzı, ör. DXB) veya kataloğumuzdan sakladığınız otel kodlarına göre arayın; pansiyon tipi ve iptal politikasıyla oda bazında fiyatları okuyun, doğrulayıp rezervasyon yapın, politikaya göre iptal edin.
Arama
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 ile sonuç kümesinin tamamını alırsınız; wait=false ile GET /v1/hotels/search/{searchId} üzerinden yoklanacak bir searchId alırsınız — fiyat anahtarlarının rezerve edilebilir kalması için aynı tarihleri ve oda sayısını gönderin. Her otel kendi içeriğini (ad, yıldız, adres, konum, ana görsel, olanaklar) ve oda başına en ucuz fiyatı opak bir rateKey, toplam ve gecelik fiyatlar, pansiyon tipi, iade edilebilirlik ve iptal son tarihiyle birlikte taşır.
Odalar ve fiyatlar
GET /v1/hotels/{hotelCode}/rooms?rateKey=…, aranan konaklama için bir tesisin tüm oda tiplerini ve fiyatlarını listeler: yatak tipleri, kapasite, pansiyon, koşullar, ayrıntılı vergi ve ücretler ve fiyatın iade edilebilir olup olmadığı.
Fiyat kontrolü
POST /v1/hotels/rates/{rateKey}/check fiyatın hâlâ rezerve edilebilir olduğunu doğrular ve nihai fiyatı ve koşulları döndürür. Bunu rezervasyondan hemen önce yapın: burada alınan bir 409 price_changed veya rate_expired, başarısız bir rezervasyondan çok daha ucuzdur.
Rezervasyon
POST /v1/hotels/bookings: rateKey, rezervasyon sahibi, oda başına misafirler ve bir iletişim kişisiyle, ayrıca bir Idempotency-Key ile. Yanıt; referansı, tedarikçi onayı ve voucher verileriyle birlikte rezervasyondur. GET /v1/hotels/bookings/{bookingId} bunu istediğiniz zaman yeniden döndürür.
İptal
GET /v1/hotels/bookings/{bookingId}/cancellation-quote, o anki koşullara göre ceza tutarını döndürür; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key zorunlu) iptali onaylar.