Duffel Flights API Entegrasyon Rehberi

Duffel Flights API canonical Offer/Order yaklaşımını açık şekilde gösteren modern bir flight supply API'dir.

Lifecycle

Offer Request
 -> Offers
 -> selected Offer
 -> optional price/services
 -> Order
 -> payment / hold
 -> change/cancel/service

Offer expires_at ile ephemeral'dir. Expired offer booking input'u olmamalıdır.

Order

Order airline booking view'ını temsil eder. Duffel dokümantasyonu airline'ın order için source of truth olduğunu ve synced_at ile son airline sync zamanını verir.

Ancillary

Offer available services üzerinden additional bag gibi ancillary'ler seçilebilir. Booking sırasında intended/selected services identity korunmalıdır.

Hold vs instant

Order:

• instant payment,
• hold then pay later

modelini offer payment requirements'a göre destekleyebilir.

Idempotency

Create Order timeout'u UNKNOWN state üretmelidir. Aynı Offer ile blind duplicate create risklidir; retrieve/reconciliation gerekir.

Observability

• offer request latency,
• offer expiry,
• order create success/unknown,
• synced_at age,
• airline initiated change,
• service/ancillary booking errors.