Әуе API

Тарифтер күнтізбесі

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 маршрут бойынша әр күннің кэштелген ең арзан тарифін валютаңызда, кэштің қаншалықты жаңа екенімен бірге қайтарады. Күндер жұбы бойынша бару-қайту сомалары үшін returnFrom / returnTo, ал класты шектеу үшін cabin қосыңыз. Ол біздің баға кэшімізден беріледі — лезде жауап береді және ешқашан жеткізуші іздеуі ретінде есептелмейді — сондықтан нақты іздеуден бұрын күнтізбе немесе «ең арзан күндер» жолағын салу үшін пайдаланыңыз.

Іздеу

POST /v1/flights/search: бір бағытқа бір сегмент, бару-қайтуға екі, көп қалалы маршрутқа алтыға дейін; түрі бойынша жолаушылар саны; қажет болса салон және ауысып отырудың ең көп саны (maxStops). wait=true болғанда жауап барлық жеткізушілер жауап бергеннен кейін әрбір ұсынысты қамтиды; wait=false болғанда searchId аласыз және complete мәні true болғанша GET /v1/flights/search/{searchId} мекенжайын cursor арқылы сұрап отырасыз.

Әр ұсыныста мөлдір емес offerId, жолаушылар бойынша бөлінген валютаңыздағы жалпы сома, slices → segments (тасымалдаушы, рейс нөмірі, уақыттар, ұшақ, салон, багаж), тариф шарттарының қысқаша мазмұны және жарамдылық мерзімі болады. Ұсыныстар іздеу сессиясы бойы (шамамен 20 минут) жарамды.

Баға және ережелер

POST /v1/flights/offers/{offerId}/price растамас бұрын тарифті жеткізушімен қайта тексереді және расталған бағаны, салықтарды және әуе компаниясы талап ететін жолаушы өрістерін (құжаттар, туған күндер, frequent flyer) қайтарады. GET .../fare-rules айыппұл мәтінін қайтарады; GET .../ancillaries тапсырысқа қосуға болатын ақылы багаж бен опцияларды тізімдейді.

Қосымша қызметтер (қосымша багаж)

GET /v1/flights/offers/{offerId}/ancillaries әуе компаниясы сол тарифте ұсынатын ақылы қосымшаларды тізімдейді — қазір тіркелетін қосымша багаж нормалары, әрқайсысы key, дана / салмақ және бір жолаушыға шаққандағы бағамен. Ақылы дегені — олар тарифке қосымша бағаланып, тапсырыспен бірге есептеледі, ұсыныстың өзінде көрсетілген кіріктірілген нормадан айырмашылығы осы.

Оларды сатып алу үшін POST /v1/flights/orders сұрауына ancillaries[] қосыңыз: әр қосымша үшін key және passengerIndex (passengers ішіндегі 0-ден басталатын индекс) бар бір жазба. Олар тапсырыспен бірге бағаланып, брондалып, билетке рәсімделеді және тапсырыстың билет сомаларында көрсетіледі. Билеті рәсімделіп қойған тапсырысқа қосымшаларды қосуға болмайды; орын таңдау да осы үлгімен жүреді.

{
  "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-та тапсырыс жеткізушінің тест жүйесіне түседі және ешқандай ақы алынбайды; production-да депозит резервке қойылады.

Билеттерді рәсімдеу

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key міндетті) электрондық билеттерді рәсімдеп, әр жолаушы үшін билет нөмірлерін қайтарады. Тапсырысты кез келген уақытта GET /v1/flights/orders/{orderId} арқылы оқыңыз; күйі held → issued → cancelled/refunded ретімен өзгереді.

Жою, күшін жою және қайтару

GET /v1/flights/orders/{orderId}/refund-quote тариф ережелері бойынша күшін жойғанда не қайтарылатынын көрсетеді (сол күнгі жою әдетте тегін). POST /v1/flights/orders/{orderId}/cancel оны растайды; қайтарылған сома әзірлеуші порталында көрінетін депозит журналыңызға түседі.