Lydira API
EN

Rezervasyon kılavuzları

Uçuş rezervasyonu

Siteniz, acentenin kendi tedarikçi bağlantılarıyla uçuş satar: arayın, fiyatlayın, opsiyon alın, ödemeyi kendi POS'unuzda alın, bileti kesin.

Adımlar

  1. 1ArayınPOST/api/v1/flights/search
  2. 2Cevabı bekleyinGET/api/v1/flights/operations/{id}
  3. 3Teklifi fiyatlayınPOST/api/v1/flights/price
  4. 4Opsiyon alınPOST/api/v1/flights/holds
  5. 5Ödemeyi alın, bileti kesinPOST/api/v1/flights/holds/{id}/ticket
  6. 6Ödenmeyen opsiyonu bırakınDELETE/api/v1/flights/holds/{id}
  7. 7Opsiyon alınamayan ücreti satın alınPOST/api/v1/flights/purchases
  8. 8Geri okuyunGET/api/v1/flights/bookings/{id}

Akış bir bakışta

  1. POST /api/v1/flights/search → bir teklif seçin.
  2. Geri okuma dışında buradaki her çağrı 202 döner (önbellekteki arama 200 döner); cevap gelene kadar GET /api/v1/flights/operations/{id} okuyun.
  3. POST /api/v1/flights/price → tutarı gösterin; belirteci saklayın.
  4. holdable ise: POST /api/v1/flights/holds → POS'unuzdan çekin → POST /api/v1/flights/holds/{id}/ticket; ödenmezse DELETE /api/v1/flights/holds/{id}.
  5. Opsiyon alınamıyorsa: POS'unuzdan çekin → POST /api/v1/flights/purchases.
  6. Numaralar için GET /api/v1/flights/bookings/{id} ya da bilet webhook'u.

Fiyat değişirse

Fiyatlama ile satın alma arasında ücret değişebilir. Çağrı rakam vermeden 409 price_changed döner. Teklifi yeniden fiyatlayın, yeni tutarı gösterin, yeni belirteci yeni bir Idempotency-Key ile gönderin. Bilet kesimi sırasında değişirse opsiyon açık kalır; bırakıp baştan başlayabilirsiniz.
409 approval_required gelirse acente bu bileti önce Lydira'da onaylar. Anahtarı bilet onay eşiği olmayan bir role bağlarsanız bu hiç olmaz.