---
title: "Duffel Flights API Entegrasyon Rehberi"
description: "Duffel Flights API'yi Offer Request, Offer, Order, baggage/ancillary, payment ve airline source-of-truth modeliyle uygulayın."
slug: "duffel-flights"
translationKey: "integration-duffel-flights"
locale: "tr"
type: "guide"
category: "flight"
tags: ["duffel","flight-api","offer","order","ancillary"]
publishedAt: "2026-09-26"
updatedAt: "2026-09-26"
reviewedAt: "2026-09-26"
technicalVerifiedAt: "2026-09-26"
sourceVersion: "Duffel Flights API v2 public docs reviewed 2026-09-26"
testedAgainst: "Official public documentation; not a live Duffel production account"
codeExampleStatus: "illustrative"
sources:
  - title: "Duffel Offer Requests"
    url: "https://duffel.com/docs/api/offer-requests"
  - title: "Duffel Offers"
    url: "https://duffel.com/docs/api/offers"
  - title: "Duffel Orders"
    url: "https://duffel.com/docs/api/orders"
---
Duffel Flights API canonical Offer/Order yaklaşımını açık şekilde gösteren modern bir flight supply API'dir.

## Lifecycle

```text
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.