Otel API
1.5M+ obyekti şəhər kodu (IATA üslubunda, məs. DXB) və ya kataloqumuzdan saxladığınız otel kodları ilə axtarın, qidalanma növü və ləğv siyasəti ilə otaq səviyyəsində tarifləri alın, yoxlayıb rezerv edin, siyasətə uyğun ləğv edin.
Axtarış
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 ilə tam nəticə dəstini alırsınız; wait=false ilə isə GET /v1/hotels/search/{searchId} ilə sorğulamaq üçün searchId — tarif açarlarının rezerv edilə bilən qalması üçün eyni tarixləri və otaq sayını ötürün. Hər otel öz məzmununu (ad, ulduzlar, ünvan, coğrafi mövqe, əsas şəkil, imkanlar) və hər otaq üçün qeyri-şəffaf rateKey ilə ən ucuz tarifi, cəmi və gecəlik qiymətləri, yeməkləmə tipini, geri qaytarıla bilənliyi və ləğv son müddətini daşıyır.
Otaqlar və tariflər
GET /v1/hotels/{hotelCode}/rooms?rateKey=… axtarılan qalma müddəti üçün bir obyektin bütün otaq növlərini və tariflərini sadalayır: çarpayı növləri, tutum, yeməkləmə, qaydalar, ayrıca göstərilən vergi və rüsumlar, həmçinin tarifin geri qaytarıla bilən olub-olmaması.
Tarif yoxlaması
POST /v1/hotels/rates/{rateKey}/check tarifin hələ də rezerv edilə bildiyini təsdiqləyir və yekun qiyməti və qaydaları qaytarır. Bunu rezervasiyadan dərhal əvvəl edin: burada 409 price_changed və ya rate_expired almaq uğursuz rezervasiyadan xeyli ucuz başa gəlir.
Rezervasiya
POST /v1/hotels/bookings: rateKey, rezervasiya sahibi, hər otaq üzrə qonaqlar və əlaqə məlumatları, üstəlik Idempotency-Key. Cavab istinad nömrəsi, təchizatçı təsdiqi və vauçer məlumatları ilə rezervasiyadır. GET /v1/hotels/bookings/{bookingId} onu istənilən vaxt yenidən qaytarır.
Ləğv
GET /v1/hotels/bookings/{bookingId}/cancellation-quote həmin an qaydalara görə cərimə məbləğini qaytarır; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key məcburidir) onu təsdiqləyir.