Mehmonxona API
1.5M+ obyektni shahar kodi (IATA uslubida, masalan DXB) yoki katalogimizdan saqlab olgan mehmonxona kodlaringiz boʻyicha qidiring, ovqatlanish turi va bekor qilish siyosati koʻrsatilgan xona darajasidagi tariflarni oling, tekshirib bron qiling, siyosatga muvofiq bekor qiling.
Qidiruv
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 bilan toʻliq natijalar toʻplamini olasiz; wait=false bilan esa GET /v1/hotels/search/{searchId} orqali soʻrab turish uchun searchId — narx kalitlari bron qilinadigan boʻlib qolishi uchun oʻsha sanalar va xonalar sonini yuboring. Har bir mehmonxonada uning kontenti (nomi, yulduzlari, manzili, geolokatsiyasi, asosiy rasmi, qulayliklari) va har bir xona uchun eng arzon narx — shaffof boʻlmagan rateKey, jami va tungi narxlar, ovqatlanish turi, qaytarilishi va bekor qilish muddati bilan bor.
Xonalar va narxlar
GET /v1/hotels/{hotelCode}/rooms?rateKey=… qidirilgan turar muddati uchun bitta obyektning barcha xona turlari va narxlarini sanab beradi: karavot turlari, sigʻim, ovqatlanish, qoidalar, alohida koʻrsatilgan soliqlar va yigʻimlar hamda narx qaytariladiganmi yoki yoʻqmi.
Narxni tekshirish
POST /v1/hotels/rates/{rateKey}/check narx hali ham bron qilinishi mumkinligini tasdiqlaydi va yakuniy narx hamda qoidalarni qaytaradi. Buni bron qilishdan bevosita oldin bajaring: bu yerdagi 409 price_changed yoki rate_expired muvaffaqiyatsiz brondan ancha arzonga tushadi.
Bron qilish
POST /v1/hotels/bookings — rateKey, bron egasi, har bir xonadagi mehmonlar va aloqa maʼlumotlari hamda Idempotency-Key bilan. Javob — raqami, yetkazib beruvchi tasdigʻi va vaucher maʼlumotlari bilan bron. GET /v1/hotels/bookings/{bookingId} uni istalgan vaqtda qayta qaytaradi.
Bekor qilish
GET /v1/hotels/bookings/{bookingId}/cancellation-quote ayni paytdagi qoidalarga koʻra jarimani qaytaradi; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key majburiy) bekor qilishni amalga oshiradi.