API πτήσεων

Ημερολόγιο ναύλων

Το GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 επιστρέφει τον φθηνότερο αποθηκευμένο ναύλο ανά ημέρα για τη διαδρομή, στο νόμισμά σας, μαζί με το πόσο πρόσφατη είναι η cache. Προσθέστε returnFrom / returnTo για σύνολα μετ' επιστροφής ανά ζεύγος ημερομηνιών και cabin για να περιορίσετε τη θέση. Εξυπηρετείται από την cache τιμών μας — άμεσα, και δεν μετρά ποτέ ως αναζήτηση σε προμηθευτή — οπότε χρησιμοποιήστε το για να σχεδιάσετε ένα ημερολόγιο ή μια λωρίδα «φθηνότερες ημέρες» πριν από την πραγματική αναζήτηση.

Αναζήτηση

POST /v1/flights/search με ένα slice για απλή μετάβαση, δύο για μετ' επιστροφής, έως έξι για πολλαπλούς προορισμούς· αριθμό επιβατών ανά τύπο· προαιρετικά θέση καμπίνας και μέγιστο αριθμό ενδιάμεσων στάσεων (maxStops). Με wait=true η απόκριση περιέχει κάθε προσφορά μόλις απαντήσουν όλοι οι προμηθευτές· με wait=false λαμβάνετε ένα searchId και κάνετε polling στο GET /v1/flights/search/{searchId} με cursor έως ότου το complete γίνει true.

Κάθε προσφορά φέρει ένα αδιαφανές offerId, το σύνολο στο νόμισμά σας με ανάλυση ανά επιβάτη, slices → segments (αερομεταφορέας, αριθμός πτήσης, ώρες, αεροσκάφος, θέση, αποσκευές), σύνοψη όρων ναύλου και χρόνο λήξης. Οι προσφορές ισχύουν για όσο διαρκεί η συνεδρία αναζήτησης (περίπου 20 λεπτά).

Τιμή και κανόνες

Το POST /v1/flights/offers/{offerId}/price επανεπικυρώνει τον ναύλο με τον προμηθευτή ακριβώς πριν δεσμευτείτε και επιστρέφει την επιβεβαιωμένη τιμή, τους φόρους και τα πεδία επιβατών που απαιτεί η αεροπορική (έγγραφα, ημερομηνίες γέννησης, πρόγραμμα επιβράβευσης). Το GET .../fare-rules επιστρέφει το κείμενο των ποινών· το GET .../ancillaries παραθέτει τις επί πληρωμή αποσκευές και επιλογές που μπορείτε να προσθέσετε στην παραγγελία.

Πρόσθετες υπηρεσίες (επιπλέον αποσκευές)

Το GET /v1/flights/offers/{offerId}/ancillaries παραθέτει τα επί πληρωμή πρόσθετα που προσφέρει η αεροπορική σε αυτόν τον ναύλο — σήμερα επιπλέον όρια παραδιδόμενων αποσκευών, το καθένα με key, τεμάχια / βάρος και τιμή ανά επιβάτη. Επί πληρωμή σημαίνει ότι τιμολογούνται επιπλέον του ναύλου και χρεώνονται με την παραγγελία, σε αντίθεση με το συμπεριλαμβανόμενο όριο που εμφανίζεται στην ίδια την προσφορά.

Για να τα αγοράσετε, προσθέστε 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.

Void, ακύρωση και επιστροφή χρημάτων

Το GET /v1/flights/orders/{orderId}/refund-quote σας λέει τι επιστρέφει μια ακύρωση σύμφωνα με τους κανόνες ναύλου (ένα void την ίδια ημέρα είναι συνήθως δωρεάν). Το POST /v1/flights/orders/{orderId}/cancel την εκτελεί· η επιστροφή πιστώνεται στο καθολικό εγγύησής σας, ορατό στην πύλη προγραμματιστών.