Uçuş API'si

Ücret takvimi

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30, rota için gün başına önbellekteki en ucuz ücreti, sizin para biriminizde ve önbelleğin ne kadar güncel olduğuyla birlikte döndürür. Tarih çifti başına gidiş-dönüş toplamları için returnFrom / returnTo, sınıfı kısıtlamak için cabin ekleyin. Fiyat önbelleğimizden sunulur — anında yanıt verir ve asla tedarikçi araması olarak sayılmaz — bu yüzden gerçek aramadan önce bir takvim veya “en ucuz günler” şeridi çizmek için kullanın.

Arama

POST /v1/flights/search: tek yön için bir dilim, gidiş-dönüş için iki, çok şehirli için en fazla altı; türe göre yolcu sayıları; isteğe bağlı bir kabin ve en fazla aktarma sayısı (maxStops). wait=true ile yanıt, tüm tedarikçiler yanıt verdikten sonra her teklifi içerir; wait=false ile bir searchId alır ve complete true olana kadar bir cursor ile GET /v1/flights/search/{searchId} adresini yoklarsınız.

Her teklif opak bir offerId, yolcu başına dökümüyle birlikte sizin para biriminizdeki toplam tutarı, dilimler → segmentler (taşıyıcı, uçuş numarası, saatler, uçak, kabin, bagaj), ücret koşulları özetini ve bir son geçerlilik zamanını taşır. Teklifler arama oturumu süresince (yaklaşık 20 dakika) geçerlidir.

Fiyat ve kurallar

POST /v1/flights/offers/{offerId}/price, işlemi onaylamadan hemen önce ücreti tedarikçiyle yeniden doğrular ve onaylanmış fiyatı, vergileri ve havayolunun zorunlu tuttuğu yolcu alanlarını (belgeler, doğum tarihleri, sık uçan yolcu) döndürür. GET .../fare-rules ceza metnini döndürür; GET .../ancillaries siparişe ekleyebileceğiniz ücretli bagajları ve seçenekleri listeler.

Ek hizmetler (ek bagaj)

GET /v1/flights/offers/{offerId}/ancillaries, havayolunun o ücrette sunduğu ücretli ekstraları listeler — şu an için ek kayıtlı bagaj hakları; her biri bir key, parça / ağırlık ve yolcu başına bir fiyatla. Ücretli olması, teklifin kendisinde gösterilen dahil bagaj hakkından farklı olarak ücretin üzerine fiyatlandırılıp siparişle birlikte faturalandırıldıkları anlamına gelir.

Satın almak için POST /v1/flights/orders isteğine ancillaries[] ekleyin: her ekstra için key ve passengerIndex (passengers dizisinde 0 tabanlı) içeren bir giriş. Siparişle birlikte fiyatlandırılır, rezerve edilir ve biletlenir; siparişin bilet toplamlarında görünür. Zaten biletlenmiş bir siparişe ekstra eklenemez; koltuk seçimi de aynı modeli izleyecektir.

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

Siparişi oluşturun

POST /v1/flights/orders: offerId, yolcular (pasaporttaki gibi adlar, tür, doğum tarihi, uluslararası güzergâhlar için belge), bir iletişim kişisi ve isteğe bağlı ancillaries[] (yukarıya bakın) ile; bir Idempotency-Key ekleyin. Bir orderId, havayolu PNR'ı, biletleme son tarihi ve held durumu döner. Test ortamında sipariş tedarikçinin test sistemine düşer ve hiçbir ücret alınmaz; canlı ortamda depozito bloke edilir.

Bilet düzenleyin

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key zorunlu) e-biletleri düzenler ve yolcu başına bilet numaralarını döndürür. Siparişi istediğiniz zaman GET /v1/flights/orders/{orderId} ile okuyun; durum held → issued → cancelled/refunded şeklinde ilerler.

Void, iptal ve iade

GET /v1/flights/orders/{orderId}/refund-quote, ücret kurallarına göre bir iptalin ne kadar iade sağlayacağını söyler (aynı gün void genellikle ücretsizdir). POST /v1/flights/orders/{orderId}/cancel işlemi onaylar; iade, geliştirici portalında görünen depozito hesap defterinize yansır.