پرواز 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 ملتا ہے اور آپ cursor کے ساتھ GET /v1/flights/search/{searchId} کو اس وقت تک چیک کرتے ہیں جب تک complete کی قدر true نہ ہو جائے۔

ہر پیشکش میں ایک مبہم offerId، آپ کی کرنسی میں کل رقم فی مسافر تفصیل کے ساتھ، slices → segments (کیریئر، پرواز نمبر، اوقات، طیارہ، کیبن، سامان)، کرایہ شرائط کا خلاصہ اور میعاد ہوتی ہے۔ پیشکشیں تلاش کے سیشن کے دوران (تقریباً 20 منٹ) کار آمد رہتی ہیں۔

قیمت اور اصول

POST /v1/flights/offers/{offerId}/price حتمی کرنے سے عین پہلے فراہم کنندہ کے ساتھ کرایے کی دوبارہ تصدیق کرتا ہے اور تصدیق شدہ قیمت، ٹیکس اور ایئر لائن کو درکار مسافر فیلڈز (دستاویزات، تاریخِ پیدائش، فریکوئنٹ فلائر) لوٹاتا ہے۔ GET .../fare-rules جرمانے کی شرائط کا متن لوٹاتا ہے؛ GET .../ancillaries ادائیگی والے سامان اور اختیارات کی فہرست دیتا ہے جو آپ آرڈر میں شامل کر سکتے ہیں۔

اضافی خدمات (اضافی سامان)

GET /v1/flights/offers/{offerId}/ancillaries اس کرایے پر ایئر لائن کی پیش کردہ ادائیگی والی اضافی خدمات کی فہرست دیتا ہے — فی الحال اضافی چیکڈ سامان کی اجازت، ہر ایک کے ساتھ ایک کلید، تعداد / وزن اور فی مسافر قیمت۔ ادائیگی والی کا مطلب ہے کہ ان کی قیمت کرایے کے علاوہ لگتی ہے اور آرڈر کے ساتھ وصول کی جاتی ہے، بخلاف اس شامل سامان کے جو پیشکش پر ہی دکھایا جاتا ہے۔

انہیں خریدنے کے لیے 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 اسے حتمی کرتا ہے؛ رقم واپسی آپ کے ڈپازٹ لیجر میں آتی ہے، جو ڈویلپر پورٹل میں نظر آتی ہے۔