उड़ान API

किराया कैलेंडर

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 रूट के लिए प्रति दिन सबसे सस्ता कैश किया गया किराया आपकी मुद्रा में लौटाता है, साथ में यह भी कि कैश कितना ताज़ा है। तारीख-जोड़ी के अनुसार राउंड-ट्रिप कुल के लिए returnFrom / returnTo जोड़ें, और क्लास सीमित करने के लिए cabin। यह हमारे प्राइस कैश से दिया जाता है — तुरंत, और इसे कभी आपूर्तिकर्ता खोज के रूप में नहीं गिना जाता — इसलिए असली खोज से पहले कैलेंडर या “सबसे सस्ते दिन” पट्टी बनाने के लिए इसका उपयोग करें।

खोज

POST /v1/flights/search: एकतरफ़ा के लिए एक स्लाइस, वापसी के लिए दो, मल्टी-सिटी के लिए छह तक; प्रकार के अनुसार यात्रियों की संख्या; वैकल्पिक केबिन और स्टॉप की अधिकतम संख्या (maxStops)। wait=true के साथ, सभी आपूर्तिकर्ताओं के जवाब देने के बाद प्रतिक्रिया में हर ऑफ़र होता है; wait=false के साथ आपको एक searchId मिलता है और आप complete के true होने तक cursor के साथ GET /v1/flights/search/{searchId} को पोल करते हैं।

हर ऑफ़र में एक अपारदर्शी offerId, प्रति-यात्री विवरण के साथ आपकी मुद्रा में कुल राशि, स्लाइस → सेगमेंट (वाहक, उड़ान संख्या, समय, विमान, केबिन, सामान), किराया शर्तों का सारांश और समाप्ति समय होता है। ऑफ़र खोज सत्र की अवधि (लगभग 20 मिनट) तक मान्य रहते हैं।

मूल्य और नियम

POST /v1/flights/offers/{offerId}/price पक्का करने से ठीक पहले आपूर्तिकर्ता के साथ किराए की दोबारा पुष्टि करता है और पुष्ट मूल्य, कर और एयरलाइन द्वारा आवश्यक यात्री फ़ील्ड (दस्तावेज़, जन्मतिथि, फ़्रीक्वेंट फ़्लायर) लौटाता है। GET .../fare-rules जुर्माने का टेक्स्ट लौटाता है; GET .../ancillaries उन सशुल्क सामान और विकल्पों की सूची देता है जिन्हें आप ऑर्डर में जोड़ सकते हैं।

अतिरिक्त सेवाएँ (अतिरिक्त सामान)

GET /v1/flights/offers/{offerId}/ancillaries उस किराए पर एयरलाइन द्वारा दी जाने वाली सशुल्क अतिरिक्त सेवाओं की सूची देता है — फ़िलहाल अतिरिक्त चेक-इन सामान भत्ते, हर एक के साथ एक key, पीस / वज़न और प्रति यात्री कीमत। सशुल्क का मतलब है कि इनकी कीमत किराए के ऊपर लगती है और ऑर्डर के साथ बिल होती है, ऑफ़र में दिखाए गए शामिल भत्ते के विपरीत।

इन्हें खरीदने के लिए POST /v1/flights/orders में ancillaries[] जोड़ें: हर अतिरिक्त सेवा के लिए key और passengerIndex (passengers में 0-आधारित) के साथ एक प्रविष्टि। इनका मूल्य निर्धारण, बुकिंग और टिकटिंग ऑर्डर के साथ ही होती है और ये ऑर्डर के टिकट कुल में दिखती हैं। पहले से टिकट जारी हो चुके ऑर्डर में अतिरिक्त सेवाएँ नहीं जोड़ी जा सकतीं; सीट चयन भी इसी पैटर्न पर आएगा।

{
  "offerId": "fo_7Gk2Qp9LcKM5aGqrMQOIzJko",
  "passengers": [{ "type": "ADT", "gender": "M", "firstName": "SAM", "lastName": "TRAVELLER", "dateOfBirth": "1990-05-04" }],
  "contact": { "email": "[email protected]", "phone": "+971501234567" },
  "ancillaries": [{ "key": "BAG20-1", "passengerIndex": 0 }]
}

ऑर्डर बनाएँ

POST /v1/flights/orders: offerId, यात्री (पासपोर्ट के अनुसार नाम, प्रकार, जन्मतिथि, अंतरराष्ट्रीय यात्रा के लिए दस्तावेज़), एक संपर्क और वैकल्पिक ancillaries[] (ऊपर देखें) के साथ; एक Idempotency-Key जोड़ें। आपको एक orderId, एयरलाइन PNR, टिकटिंग की समय-सीमा और स्थिति held मिलती है। सैंडबॉक्स में ऑर्डर आपूर्तिकर्ता के टेस्ट सिस्टम में जाता है और कोई शुल्क नहीं लगता; प्रोडक्शन में जमा राशि आरक्षित की जाती है।

टिकट जारी करें

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key आवश्यक) ई-टिकट जारी करता है और प्रति यात्री टिकट नंबर लौटाता है। ऑर्डर को कभी भी GET /v1/flights/orders/{orderId} से पढ़ें; स्थिति held → issued → cancelled/refunded क्रम में बदलती है।

वॉयड, रद्दीकरण और रिफ़ंड

GET /v1/flights/orders/{orderId}/refund-quote बताता है कि किराया नियमों के तहत रद्दीकरण पर कितना वापस मिलेगा (उसी दिन का वॉयड आमतौर पर मुफ़्त होता है)। POST /v1/flights/orders/{orderId}/cancel इसे पक्का करता है; रिफ़ंड आपके जमा लेजर में आता है, जो डेवलपर पोर्टल में दिखता है।