API ya Ndege

Kalenda ya nauli

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 hurudisha nauli nafuu zaidi iliyohifadhiwa kwa kila siku ya njia hiyo, katika sarafu yako, pamoja na jinsi akiba hiyo ilivyo mpya. Ongeza returnFrom / returnTo kupata jumla za kwenda na kurudi kwa kila jozi ya tarehe, na cabin kuzuia daraja. Hutolewa kutoka kwenye akiba yetu ya bei — papo hapo, na kamwe haihesabiwi kama utafutaji kwa msambazaji — kwa hiyo itumie kuchora kalenda au ukanda wa “siku nafuu zaidi” kabla ya utafutaji halisi.

Utafutaji

POST /v1/flights/search ikiwa na kipande kimoja kwa safari ya kwenda tu, viwili kwa kwenda na kurudi, hadi sita kwa miji mingi; idadi ya abiria kwa aina; daraja la hiari na idadi ya juu ya vituo (maxStops). Kwa wait=true jibu hubeba kila ofa baada ya wasambazaji wote kujibu; kwa wait=false unapata searchId na unauliza GET /v1/flights/search/{searchId} kwa kishale hadi complete iwe true.

Kila ofa hubeba offerId isiyo na maana ya ndani, jumla katika sarafu yako pamoja na mgawanyo kwa kila abiria, vipande → sehemu (mbebaji, namba ya safari, nyakati, ndege, daraja, mizigo), muhtasari wa masharti ya nauli na muda wa kuisha. Ofa ni halali katika muda wote wa kipindi cha utafutaji (takriban dakika 20).

Bei na kanuni

POST /v1/flights/offers/{offerId}/price huthibitisha upya nauli na msambazaji kabla tu ya kuthibitisha na hurudisha bei iliyothibitishwa, kodi na sehemu za abiria ambazo shirika la ndege linahitaji (hati, tarehe za kuzaliwa, frequent flyer). GET .../fare-rules hurudisha maandishi ya adhabu; GET .../ancillaries huorodhesha mizigo ya kulipia na chaguo unazoweza kuongeza kwenye oda.

Huduma za ziada (mizigo ya ziada)

GET /v1/flights/offers/{offerId}/ancillaries huorodhesha huduma za ziada za kulipia ambazo shirika la ndege hutoa kwa nauli hiyo — kwa sasa viwango vya ziada vya mizigo inayokabidhiwa, kila kimoja kikiwa na ufunguo, idadi ya vipande / uzito na bei kwa kila abiria. Za kulipia maana yake zinapangiwa bei juu ya nauli na kutozwa pamoja na oda, tofauti na mizigo iliyojumuishwa inayoonyeshwa kwenye ofa yenyewe.

Ili kuzinunua, ongeza ancillaries[] kwenye POST /v1/flights/orders: ingizo moja kwa kila huduma ya ziada likiwa na key na passengerIndex (faharasa inayoanzia 0 ndani ya passengers). Hupangiwa bei, huwekewa nafasi na hutolewa tiketi pamoja na oda na huonekana kwenye jumla za tiketi za oda. Huduma za ziada haziwezi kuongezwa kwenye oda ambayo tayari imetolewa tiketi; uchaguzi wa kiti utafuata utaratibu huo huo.

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

Unda oda

POST /v1/flights/orders ikiwa na offerId, abiria (majina kama kwenye pasipoti, aina, tarehe ya kuzaliwa, hati kwa safari za kimataifa), mawasiliano na ancillaries[] ya hiari (tazama hapo juu); ongeza Idempotency-Key. Unapokea orderId, PNR ya shirika la ndege, muda wa mwisho wa kutoa tiketi na hali held. Kwenye sandbox oda huingia kwenye mfumo wa majaribio wa msambazaji na hakuna malipo; kwenye uzalishaji amana huzuiliwa.

Toa tiketi

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key inahitajika) hutoa tiketi za kielektroniki na hurudisha namba za tiketi kwa kila abiria. Soma oda wakati wowote kwa GET /v1/flights/orders/{orderId}; hali hupitia held → issued → cancelled/refunded.

Kubatilisha, kughairi na kurejesha pesa

GET /v1/flights/orders/{orderId}/refund-quote hukueleza kiasi ambacho kughairi kunarudisha chini ya kanuni za nauli (ubatilishaji wa siku ile ile kwa kawaida ni bure). POST /v1/flights/orders/{orderId}/cancel hukutekeleza; marejesho huingia kwenye leja ya amana yako, yakionekana kwenye lango la wasanidi programu.