ہوٹل API

تلاش

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 جسے 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 بھی۔ جواب میں بکنگ اپنے حوالے، فراہم کنندہ کی تصدیق اور واؤچر کے ڈیٹا کے ساتھ آتی ہے۔ GET /v1/hotels/bookings/{bookingId} اسے کسی بھی وقت دوبارہ لوٹاتا ہے۔

منسوخی

GET /v1/hotels/bookings/{bookingId}/cancellation-quote اس لمحے پالیسی کے تحت جرمانہ لوٹاتا ہے؛ POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key ضروری) اسے حتمی کرتا ہے۔