Parvoz API

Tariflar taqvimi

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 yoʻnalish boʻyicha har bir kun uchun keshdagi eng arzon tarifni valyutangizda, kesh qanchalik yangiligi bilan birga qaytaradi. Har bir sana juftligi uchun borib-kelish summalarini olish uchun returnFrom / returnTo, klassni cheklash uchun cabin qoʻshing. U narxlar keshimizdan beriladi — bir zumda va hech qachon yetkazib beruvchi qidiruvi sifatida hisoblanmaydi — shuning uchun undan haqiqiy qidiruvdan oldin taqvim yoki “eng arzon kunlar” tasmasini chizishda foydalaning.

Qidiruv

POST /v1/flights/search — bir tomonlama uchun bitta segment, borib-kelish uchun ikkita, murakkab yoʻnalish uchun oltitagacha; yoʻlovchilar soni turlar boʻyicha; ixtiyoriy klass va oraliq qoʻnishlarning eng koʻp soni (maxStops). wait=true bilan javob barcha yetkazib beruvchilar javob bergach, barcha takliflarni oʻz ichiga oladi; wait=false bilan searchId olasiz va complete true boʻlguncha kursor bilan GET /v1/flights/search/{searchId} ni soʻrab turasiz.

Har bir taklifda shaffof boʻlmagan offerId, valyutangizdagi jami summa va har bir yoʻlovchi boʻyicha taqsimot, segmentlar → reyslar (tashuvchi, reys raqami, vaqtlar, samolyot, klass, bagaj), tarif shartlari xulosasi va amal qilish muddati bor. Takliflar qidiruv sessiyasi davomida (taxminan 20 daqiqa) amal qiladi.

Narx va qoidalar

POST /v1/flights/offers/{offerId}/price majburiyat olishingizdan oldin tarifni yetkazib beruvchi bilan qayta tasdiqlaydi va tasdiqlangan narx, soliqlar hamda aviakompaniya talab qiladigan yoʻlovchi maydonlarini (hujjatlar, tugʻilgan sanalar, frequent flyer) qaytaradi. GET .../fare-rules jarima matnini qaytaradi; GET .../ancillaries buyurtmaga qoʻshishingiz mumkin boʻlgan pullik bagaj va variantlarni sanab beradi.

Qoʻshimcha xizmatlar (qoʻshimcha bagaj)

GET /v1/flights/offers/{offerId}/ancillaries aviakompaniya shu tarifda taklif qiladigan pullik qoʻshimchalarni sanab beradi — hozircha qoʻshimcha roʻyxatdan oʻtkaziladigan bagaj miqdorlari, har biri kalit, dona / ogʻirlik va har bir yoʻlovchi uchun narx bilan. Pullik degani — ular tarif ustiga narxlanadi va buyurtma bilan birga hisoblanadi, taklifning oʻzida koʻrsatilgan kiritilgan bagajdan farqli ravishda.

Ularni sotib olish uchun POST /v1/flights/orders ga ancillaries[] qoʻshing: har bir qoʻshimcha uchun key va passengerIndex (passengers ichidagi 0 dan boshlanadigan indeks) bilan bitta yozuv. Ular buyurtma bilan birga narxlanadi, bron qilinadi va chiptaga kiritiladi hamda buyurtmaning chipta summalarida koʻrinadi. Chiptasi allaqachon rasmiylashtirilgan buyurtmaga qoʻshimchalar qoʻshib boʻlmaydi; oʻrindiq tanlash ham xuddi shu tartibda qoʻshiladi.

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

Buyurtma yaratish

POST /v1/flights/orders — offerId, yoʻlovchilar (pasportdagidek ismlar, turi, tugʻilgan sana, xalqaro yoʻnalishlar uchun hujjat), aloqa maʼlumotlari va ixtiyoriy ancillaries[] (yuqoriga qarang) bilan; Idempotency-Key qoʻshing. Siz orderId, aviakompaniya PNR, chipta rasmiylashtirish muddati va held holatini olasiz. Sandboxʼda buyurtma yetkazib beruvchining test tizimiga tushadi va hech narsa hisobdan yechilmaydi; productionʼda depozit band qilinadi.

Chiptalarni rasmiylashtirish

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key majburiy) elektron chiptalarni rasmiylashtiradi va har bir yoʻlovchi uchun chipta raqamlarini qaytaradi. Buyurtmani istalgan vaqtda GET /v1/flights/orders/{orderId} bilan oʻqing; holat held → issued → cancelled/refunded tartibida oʻzgaradi.

Void, bekor qilish va qaytarish

GET /v1/flights/orders/{orderId}/refund-quote tarif qoidalariga koʻra bekor qilishda nima qaytishini aytadi (oʻsha kundagi void odatda bepul). POST /v1/flights/orders/{orderId}/cancel uni amalga oshiradi; qaytarilgan mablagʻ depozit hisob daftaringizga tushadi va dasturchi portalida koʻrinadi.