Uçuş API

Tarif təqvimi

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 marşrut üçün hər gün üzrə keşlənmiş ən ucuz tarifi valyutanızda, keşin nə qədər təzə olduğu ilə birlikdə qaytarır. Tarix cütləri üzrə gediş-dönüş cəmləri üçün returnFrom / returnTo, sinfi məhdudlaşdırmaq üçün isə cabin əlavə edin. O, qiymət keşimizdən verilir — ani cavab verir və heç vaxt təchizatçı axtarışı kimi sayılmır — buna görə real axtarışdan əvvəl təqvim və ya “ən ucuz günlər” zolağı çəkmək üçün ondan istifadə edin.

Axtarış

POST /v1/flights/search: birtərəfli üçün bir seqment, gediş-dönüş üçün iki, çoxşəhərli marşrut üçün altıya qədər; növ üzrə sərnişin sayları; istəyə bağlı kabin və maksimum aralıq eniş sayı (maxStops). wait=true ilə cavab bütün təchizatçılar cavab verdikdən sonra hər təklifi ehtiva edir; wait=false ilə searchId alırsınız və complete true olana qədər GET /v1/flights/search/{searchId} ünvanını cursor ilə sorğulayırsınız.

Hər təklif qeyri-şəffaf offerId, sərnişin üzrə bölgü ilə valyutanızda cəmi məbləğ, slices → segments (daşıyıcı, reys nömrəsi, vaxtlar, təyyarə, kabin, baqaj), tarif şərtlərinin xülasəsi və bitmə vaxtı daşıyır. Təkliflər axtarış sessiyası müddətində (təxminən 20 dəqiqə) etibarlıdır.

Qiymət və qaydalar

POST /v1/flights/offers/{offerId}/price təsdiqləməzdən dərhal əvvəl tarifi təchizatçı ilə yenidən yoxlayır və təsdiqlənmiş qiyməti, vergiləri və aviaşirkətin tələb etdiyi sərnişin sahələrini (sənədlər, doğum tarixləri, frequent flyer) qaytarır. GET .../fare-rules cərimə mətnini qaytarır; GET .../ancillaries sifarişə əlavə edə biləcəyiniz ödənişli baqajı və seçimləri sadalayır.

Əlavə xidmətlər (artıq baqaj)

GET /v1/flights/offers/{offerId}/ancillaries aviaşirkətin həmin tarifdə təklif etdiyi ödənişli əlavələri sadalayır — hazırda əlavə qeydiyyat baqajı normaları, hər biri key, ədəd / çəki və sərnişin başına qiymət ilə. Ödənişli o deməkdir ki, onlar tarifin üzərinə qiymətləndirilir və sifarişlə birlikdə hesablanır, təklifin özündə göstərilən daxil edilmiş normadan fərqli olaraq.

Onları almaq üçün POST /v1/flights/orders sorğusuna ancillaries[] əlavə edin: hər əlavə üçün key və passengerIndex (passengers massivində 0-dan başlayan indeks) ilə bir element. Onlar sifarişlə birlikdə qiymətləndirilir, rezerv edilir və biletləşdirilir və sifarişin bilet cəmlərində görünür. Artıq biletləşdirilmiş sifarişə əlavələr əlavə edilə bilməz; oturacaq seçimi də eyni modeli izləyəcək.

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

Sifarişi yaradın

POST /v1/flights/orders: offerId, sərnişinlər (pasportdakı kimi adlar, növ, doğum tarixi, beynəlxalq marşrutlar üçün sənəd), əlaqə məlumatları və istəyə bağlı ancillaries[] (yuxarıya baxın); Idempotency-Key əlavə edin. Siz orderId, aviaşirkətin PNR-i, biletin rəsmiləşdirilməsi üçün son müddət və held statusunu alırsınız. Sandbox-da sifariş təchizatçının test sisteminə düşür və heç nə ödənilmir; production-da depozit rezerv edilir.

Biletləri rəsmiləşdirin

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key məcburidir) elektron biletləri rəsmiləşdirir və hər sərnişin üçün bilet nömrələrini qaytarır. Sifarişi istənilən vaxt GET /v1/flights/orders/{orderId} ilə oxuyun; status held → issued → cancelled/refunded ardıcıllığı ilə dəyişir.

Annulyasiya, ləğv və geri qaytarma

GET /v1/flights/orders/{orderId}/refund-quote ləğv zamanı tarif qaydalarına görə nəyin geri qaytarılacağını bildirir (eyni gün annulyasiyası adətən pulsuzdur). POST /v1/flights/orders/{orderId}/cancel onu təsdiqləyir; geri qaytarılan məbləğ tərtibatçı portalında görünən depozit jurnalınıza düşür.