ממשק הטיסות

לוח מחירים

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 ומתשאלים את GET /v1/flights/search/{searchId} עם סמן עד שהערך של complete הוא true.

כל הצעה נושאת offerId אטום, את הסכום הכולל במטבע שלכם עם פירוט לפי נוסע, מקטעים ← קטעי טיסה (מוביל, מספר טיסה, זמנים, מטוס, מחלקה, כבודה), תקציר תנאי המחיר ומועד תפוגה. ההצעות תקפות לאורך סשן החיפוש (כ-20 דקות).

מחיר וכללים

POST /v1/flights/offers/{offerId}/price מאמת מחדש את המחיר מול הספק ממש לפני ההתחייבות ומחזיר את המחיר המאושר, המסים ושדות הנוסע שחברת התעופה דורשת (מסמכים, תאריכי לידה, מועדון נוסע מתמיד). GET .../fare-rules מחזיר את נוסח הקנסות; GET .../ancillaries מפרט כבודה בתשלום ואפשרויות שאפשר להוסיף להזמנה.

שירותים נלווים (כבודה נוספת)

GET /v1/flights/offers/{offerId}/ancillaries מפרט את התוספות בתשלום שחברת התעופה מציעה במחיר הזה — כיום תוספות של כבודה רשומה, כל אחת עם key, pieces / weight ומחיר לנוסע. בתשלום פירושו שהן מתומחרות מעבר למחיר הכרטיס ומחויבות יחד עם ההזמנה, בשונה מהכבודה הכלולה שמוצגת בהצעה עצמה.

כדי לרכוש אותן, הוסיפו ancillaries[] ל-POST /v1/flights/orders: רשומה אחת לכל תוספת עם ה-key וה-passengerIndex (אינדקס מבוסס 0 בתוך passengers). הן מתומחרות, מוזמנות ומונפקות יחד עם ההזמנה ומופיעות בסכומי הכרטיסים של ההזמנה. אי אפשר להוסיף תוספות להזמנה שכבר הונפקו לה כרטיסים; בחירת מושבים תפעל באותה שיטה.

{
  "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. ב-Sandbox ההזמנה נקלטת במערכת הבדיקה של הספק ושום דבר לא מחויב; בייצור הסכום נשמר בפיקדון.

הנפקת כרטיסים

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 מבצע אותו; ההחזר נרשם בכרטסת הפיקדון שלכם וגלוי בפורטל המפתחים.