API zboruri

Calendar de tarife

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 întoarce cel mai ieftin tarif din cache pentru fiecare zi pe ruta respectivă, în moneda ta, împreună cu vechimea cache-ului. Adaugă returnFrom / returnTo pentru totaluri dus-întors pe fiecare pereche de date și cabin pentru a restrânge clasa. Este servit din cache-ul nostru de prețuri — instantaneu și niciodată contorizat ca o căutare la furnizor — așa că folosește-l pentru a desena un calendar sau o bandă „zilele cele mai ieftine” înaintea căutării reale.

Căutare

POST /v1/flights/search cu un slice pentru dus, două pentru dus-întors, până la șase pentru mai multe orașe; numărul de pasageri pe tip; o cabină opțională și un număr maxim de escale (maxStops). Cu wait=true, răspunsul conține toate ofertele după ce au răspuns toți furnizorii; cu wait=false primești un searchId și interoghezi GET /v1/flights/search/{searchId} cu un cursor până când complete este true.

Fiecare ofertă conține un offerId opac, totalul în moneda ta cu defalcarea pe pasager, slices → segments (companie aeriană, număr de zbor, ore, aeronavă, cabină, bagaj), un rezumat al condițiilor tarifare și o dată de expirare. Ofertele sunt valabile pe durata sesiunii de căutare (aproximativ 20 de minute).

Preț și reguli

POST /v1/flights/offers/{offerId}/price revalidează tariful la furnizor chiar înainte de confirmare și întoarce prețul confirmat, taxele și câmpurile de pasager cerute de compania aeriană (documente, date de naștere, program de fidelitate). GET .../fare-rules întoarce textul penalităților; GET .../ancillaries listează bagajele cu plată și opțiunile pe care le poți adăuga la comandă.

Servicii suplimentare (bagaj suplimentar)

GET /v1/flights/offers/{offerId}/ancillaries listează extraopțiunile cu plată oferite de compania aeriană pentru acel tarif — deocamdată franciză suplimentară de bagaj de cală, fiecare cu un key, număr de bucăți / greutate și un preț per pasager. Cu plată înseamnă că se taxează peste tarif și se facturează odată cu comanda, spre deosebire de franciza inclusă afișată în oferta propriu-zisă.

Pentru a le cumpăra, adaugă ancillaries[] la POST /v1/flights/orders: câte o intrare pentru fiecare extraopțiune, cu key și passengerIndex (indice de la 0 în passengers). Sunt tarifate, rezervate și emise împreună cu comanda și apar în totalurile biletelor din comandă. Extraopțiunile nu pot fi adăugate la o comandă pentru care biletul a fost deja emis; selecția locurilor va urma același model.

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

Creează comanda

POST /v1/flights/orders cu offerId, pasagerii (numele ca în pașaport, tip, data nașterii, document pentru itinerariile internaționale), datele de contact și ancillaries[] opțional (vezi mai sus); adaugă un Idempotency-Key. Primești un orderId, PNR-ul companiei aeriene, termenul-limită de emitere și starea held. În sandbox, comanda ajunge în sistemul de test al furnizorului și nu se taxează nimic; în producție, suma este rezervată din depozit.

Emite biletele

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key obligatoriu) emite biletele electronice și întoarce numerele de bilet pentru fiecare pasager. Citește comanda oricând cu GET /v1/flights/orders/{orderId}; starea trece prin held → issued → cancelled/refunded.

Void, anulare și rambursare

GET /v1/flights/orders/{orderId}/refund-quote îți spune ce returnează o anulare conform regulilor tarifare (un void în aceeași zi este de obicei gratuit). POST /v1/flights/orders/{orderId}/cancel o confirmă; rambursarea ajunge în registrul depozitului tău, vizibil în portalul pentru dezvoltatori.