API Penerbangan

Kalendar tambang

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 mengembalikan tambang cache termurah bagi setiap hari untuk laluan tersebut, dalam mata wang anda, berserta tahap kesegaran cache. Tambah returnFrom / returnTo untuk jumlah pergi-balik bagi setiap pasangan tarikh, dan cabin untuk mengehadkan kelas. Ia disajikan daripada cache harga kami — serta-merta, dan tidak pernah dikira sebagai carian pembekal — jadi gunakannya untuk melukis kalendar atau jalur “hari termurah” sebelum carian sebenar.

Carian

POST /v1/flights/search dengan satu slice untuk sehala, dua untuk pergi-balik, sehingga enam untuk berbilang bandar; bilangan penumpang mengikut jenis; kabin pilihan dan bilangan maksimum persinggahan (maxStops). Dengan wait=true, respons mengandungi setiap tawaran sebaik sahaja semua pembekal menjawab; dengan wait=false anda mendapat searchId dan meninjau GET /v1/flights/search/{searchId} dengan cursor sehingga complete bernilai true.

Setiap tawaran membawa offerId yang legap, jumlah dalam mata wang anda berserta pecahan bagi setiap penumpang, slices → segments (syarikat penerbangan, nombor penerbangan, masa, pesawat, kabin, bagasi), ringkasan syarat tambang dan masa tamat. Tawaran sah sepanjang hayat sesi carian (kira-kira 20 minit).

Harga dan peraturan

POST /v1/flights/offers/{offerId}/price mengesahkan semula tambang dengan pembekal sejurus sebelum anda komit dan mengembalikan harga yang disahkan, cukai serta medan penumpang yang diperlukan oleh syarikat penerbangan (dokumen, tarikh lahir, penumpang kerap). GET .../fare-rules mengembalikan teks penalti; GET .../ancillaries menyenaraikan bagasi berbayar dan pilihan yang boleh anda tambah pada pesanan.

Perkhidmatan tambahan (bagasi tambahan)

GET /v1/flights/offers/{offerId}/ancillaries menyenaraikan tambahan berbayar yang ditawarkan oleh syarikat penerbangan pada tambang tersebut — buat masa ini peruntukan bagasi daftar masuk tambahan, masing-masing dengan key, bilangan beg / berat dan harga bagi setiap penumpang. Berbayar bermaksud ia dikenakan harga di atas tambang dan dibilkan bersama pesanan, tidak seperti peruntukan termasuk yang dipaparkan pada tawaran itu sendiri.

Untuk membelinya, tambah ancillaries[] pada POST /v1/flights/orders: satu entri bagi setiap tambahan dengan key dan passengerIndex (berasaskan 0 dalam passengers). Ia ditetapkan harga, ditempah dan dikeluarkan tiket bersama pesanan dan muncul dalam jumlah tiket pesanan. Tambahan tidak boleh ditambah pada pesanan yang tiketnya sudah dikeluarkan; pemilihan tempat duduk akan mengikut corak yang sama.

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

Cipta pesanan

POST /v1/flights/orders dengan offerId, penumpang (nama seperti dalam pasport, jenis, tarikh lahir, dokumen untuk jadual perjalanan antarabangsa), maklumat hubungan dan ancillaries[] pilihan (lihat di atas); tambah Idempotency-Key. Anda menerima orderId, PNR syarikat penerbangan, had masa pengeluaran tiket dan status held. Dalam sandbox, pesanan masuk ke sistem ujian pembekal dan tiada caj dikenakan; dalam production, deposit ditahan.

Keluarkan tiket

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key diperlukan) mengeluarkan e-tiket dan mengembalikan nombor tiket bagi setiap penumpang. Baca pesanan pada bila-bila masa dengan GET /v1/flights/orders/{orderId}; status bergerak melalui held → issued → cancelled/refunded.

Void, pembatalan dan bayaran balik

GET /v1/flights/orders/{orderId}/refund-quote memberitahu anda jumlah yang dikembalikan oleh pembatalan mengikut peraturan tambang (void pada hari yang sama biasanya percuma). POST /v1/flights/orders/{orderId}/cancel melaksanakannya; bayaran balik masuk ke lejar deposit anda, yang boleh dilihat dalam portal pembangun.