API Penerbangan

Kalender tarif

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 mengembalikan tarif termurah yang tersimpan di cache per hari untuk rute tersebut, dalam mata uang Anda, beserta seberapa baru cache tersebut. Tambahkan returnFrom / returnTo untuk total pulang-pergi per pasangan tanggal, dan cabin untuk membatasi kelas. Data ini disajikan dari cache harga kami — instan, dan tidak pernah dihitung sebagai pencarian pemasok — jadi gunakan untuk menampilkan kalender atau strip “hari termurah” sebelum pencarian sebenarnya.

Pencarian

POST /v1/flights/search dengan satu slice untuk sekali jalan, dua untuk pulang-pergi, hingga enam untuk multi-kota; jumlah penumpang per tipe; kabin opsional dan jumlah transit maksimum (maxStops). Dengan wait=true respons berisi setiap penawaran setelah semua pemasok menjawab; dengan wait=false Anda mendapat searchId dan melakukan polling GET /v1/flights/search/{searchId} dengan cursor hingga complete bernilai true.

Setiap penawaran membawa offerId yang opak, total dalam mata uang Anda dengan rincian per penumpang, slices → segments (maskapai, nomor penerbangan, waktu, pesawat, kabin, bagasi), ringkasan ketentuan tarif, dan waktu kedaluwarsa. Penawaran berlaku selama sesi pencarian (sekitar 20 menit).

Harga dan aturan

POST /v1/flights/offers/{offerId}/price memvalidasi ulang tarif dengan pemasok tepat sebelum Anda berkomitmen dan mengembalikan harga yang dikonfirmasi, pajak, serta kolom penumpang yang diwajibkan maskapai (dokumen, tanggal lahir, frequent flyer). GET .../fare-rules mengembalikan teks penalti; GET .../ancillaries mencantumkan bagasi berbayar dan opsi yang dapat Anda tambahkan ke pesanan.

Layanan tambahan (bagasi ekstra)

GET /v1/flights/offers/{offerId}/ancillaries mencantumkan tambahan berbayar yang ditawarkan maskapai untuk tarif tersebut — saat ini jatah bagasi terdaftar ekstra, masing-masing dengan key, jumlah koli / berat, dan harga per penumpang. Berbayar berarti harganya ditambahkan di atas tarif dan ditagihkan bersama pesanan, berbeda dengan jatah bagasi yang sudah termasuk dan ditampilkan pada penawaran itu sendiri.

Untuk membelinya, tambahkan ancillaries[] ke POST /v1/flights/orders: satu entri per tambahan dengan key dan passengerIndex (berbasis 0 pada passengers). Tambahan diberi harga, dipesan, dan diterbitkan tiketnya bersama pesanan, dan muncul pada total tiket pesanan. Tambahan tidak dapat ditambahkan ke pesanan yang tiketnya sudah terbit; pemilihan kursi akan mengikuti pola 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 }]
}

Buat pesanan

POST /v1/flights/orders dengan offerId, penumpang (nama sesuai paspor, tipe, tanggal lahir, dokumen untuk rute internasional), kontak, dan ancillaries[] opsional (lihat di atas); tambahkan Idempotency-Key. Anda menerima orderId, PNR maskapai, batas waktu penerbitan tiket, dan status held. Di sandbox, pesanan masuk ke sistem uji pemasok dan tidak ada yang ditagih; di produksi, deposit dicadangkan.

Terbitkan tiket

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key wajib) menerbitkan e-tiket dan mengembalikan nomor tiket per penumpang. Baca pesanan kapan saja dengan GET /v1/flights/orders/{orderId}; statusnya bergerak melalui held → issued → cancelled/refunded.

Void, pembatalan, dan pengembalian dana

GET /v1/flights/orders/{orderId}/refund-quote memberi tahu berapa yang dikembalikan dari sebuah pembatalan menurut aturan tarif (void pada hari yang sama biasanya gratis). POST /v1/flights/orders/{orderId}/cancel mengeksekusinya; pengembalian dana masuk ke buku besar deposit Anda, terlihat di portal pengembang.