হোটেল 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 আবশ্যক) এটি কার্যকর করে।