Flug-API

Tarifkalender

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 liefert den günstigsten zwischengespeicherten Tarif pro Tag für die Strecke, in Ihrer Währung, zusammen mit der Aktualität des Caches. Fügen Sie returnFrom / returnTo für Hin- und Rückflug-Summen pro Datumspaar hinzu und cabin, um die Klasse einzuschränken. Die Daten kommen aus unserem Preis-Cache – sofort verfügbar und nie als Anbietersuche gezählt –, nutzen Sie sie also, um vor der eigentlichen Suche einen Kalender oder eine Leiste mit den „günstigsten Tagen“ anzuzeigen.

Suche

POST /v1/flights/search mit einem Slice für einen einfachen Flug, zwei für Hin- und Rückflug und bis zu sechs für Gabelflüge; Passagieranzahl nach Typ; optional eine Kabine und eine maximale Anzahl an Umstiegen (maxStops). Mit wait=true enthält die Antwort alle Angebote, sobald alle Anbieter geantwortet haben; mit wait=false erhalten Sie eine searchId und fragen GET /v1/flights/search/{searchId} mit einem Cursor ab, bis complete true ist.

Jedes Angebot enthält eine undurchsichtige offerId, den Gesamtbetrag in Ihrer Währung mit Aufschlüsselung pro Passagier, Slices → Segmente (Fluggesellschaft, Flugnummer, Zeiten, Flugzeug, Kabine, Gepäck), eine Zusammenfassung der Tarifbedingungen und ein Ablaufdatum. Angebote sind für die Dauer der Suchsitzung gültig (etwa 20 Minuten).

Preis und Regeln

POST /v1/flights/offers/{offerId}/price revalidiert den Tarif unmittelbar vor der verbindlichen Aktion beim Anbieter und liefert den bestätigten Preis, die Steuern und die Passagierfelder, die die Fluggesellschaft verlangt (Dokumente, Geburtsdaten, Vielfliegernummer). GET .../fare-rules liefert den Text zu den Gebühren; GET .../ancillaries listet kostenpflichtiges Gepäck und Optionen, die Sie dem Auftrag hinzufügen können.

Zusatzleistungen (Zusatzgepäck)

GET /v1/flights/offers/{offerId}/ancillaries listet die kostenpflichtigen Extras, die die Fluggesellschaft für diesen Tarif anbietet – derzeit zusätzliche Freigepäckmengen, jeweils mit einem key, Stückzahl / Gewicht und einem Preis pro Passagier. Kostenpflichtig heißt, dass sie zusätzlich zum Tarif berechnet und mit dem Auftrag abgerechnet werden, anders als das im Angebot selbst angezeigte inkludierte Freigepäck.

Um sie zu kaufen, fügen Sie ancillaries[] zu POST /v1/flights/orders hinzu: ein Eintrag pro Extra mit dem key und dem passengerIndex (0-basiert in passengers). Sie werden zusammen mit dem Auftrag bepreist, gebucht und ausgestellt und erscheinen in den Ticketsummen des Auftrags. Zu einem bereits ausgestellten Auftrag können keine Extras hinzugefügt werden; die Sitzplatzwahl folgt demselben Muster.

{
  "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 }]
}

Auftrag erstellen

POST /v1/flights/orders mit der offerId, den Passagieren (Namen wie im Reisepass, Typ, Geburtsdatum, Dokument bei internationalen Reiserouten), einem Kontakt und optional ancillaries[] (siehe oben); fügen Sie einen Idempotency-Key hinzu. Sie erhalten eine orderId, den PNR der Fluggesellschaft, die Ticketing-Frist und den Status held. In der Sandbox landet der Auftrag im Testsystem des Anbieters und es wird nichts belastet; in der Produktion wird die Einlage reserviert.

Tickets ausstellen

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key erforderlich) stellt E-Tickets aus und liefert die Ticketnummern pro Passagier. Den Auftrag können Sie jederzeit mit GET /v1/flights/orders/{orderId} abrufen; der Status durchläuft held → issued → cancelled/refunded.

Void, Stornierung und Erstattung

GET /v1/flights/orders/{orderId}/refund-quote zeigt Ihnen, was eine Stornierung nach den Tarifregeln erstattet (ein Void am selben Tag ist meist kostenlos). POST /v1/flights/orders/{orderId}/cancel führt sie verbindlich aus; die Erstattung wird Ihrem Einlagenkonto gutgeschrieben, sichtbar im Entwicklerportal.