होटल 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 आवश्यक) इसे पक्का करता है।