Güncellemeler

Partner API v1.5.6

4 Ekim 2026 — Varsayılan Public Host (sefera-api.web.app)

Partner API ve airline logoUrl varsayılan public host’u, doğrulanmış Hosting rewrite olan sefera-api.web.app olarak belgelendi; özel alan adı DNS hazır olunca isteğe bağlıdır.

DÜZELTME

• Portal OpenAPI sunucusu, README örnekleri ve airline logoUrl tabanı artık varsayılan olarak https://sefera-api.web.app kullanır.
• PARTNER_API_PUBLIC_BASE_URL varsayılanı aynı Hosting host’una alındı; logo URL’leri yalnız NXDOMAIN özel alan adına bağlı kalmaz.
• İnsan README detay alanları OpenAPI ile hizalandı; kaldırılmış guide.name belgesi çıkarıldı.

UYUMLULUK

• Path sözleşmesi değişmedi (/v1/programs). Env override yoksa yeni yanıtlardaki logoUrl host metni sefera-api.web.app olur.
• Özel alan adı DNS hazır olduğunda PARTNER_API_PUBLIC_BASE_URL=https://api.sefera.com.tr ile logo host’u değiştirilebilir.

Partner API v1.5.5

28 Eylül 2026 — Program Numarası (programNumber)

Liste ve detay yanıtlarındaki programNumber alanı, acenta panelindeki “No. N” program numarası olarak belgelendi ve her yanıtta garanti edildi.

YENİ

• programNumber artık şemada zorunlu (required) alan: GET /v1/programs öğelerinde ve GET /v1/programs/{programId} yanıtında her zaman bulunur, iki uçta aynı değeri taşır.
• Değer acenta içinde benzersizdir, program oluşturulurken bir kez atanır; sonradan değişmez ve başka programa tekrar verilmez.
• Numarası olmayan eski programlarda programNumber null döner.
• Örnek yanıtlar programNumber içerecek şekilde güncellendi.

DÜZELTME

• Dokümantasyon programNumber alanının numara yoksa yanıttan çıkarıldığını söylüyordu; gerçek davranış alanın null olarak dönmesidir.
• Portal örnek yanıtlarından şemada artık yer almayan guide ve staff alanları çıkarıldı; detay örneği guides alanını gösterir.
• Program detayı, veri modeli ve Oteller sayfalarındaki eski Guide / Staff / StaffTeacher tabloları kaldırıldı; yerine yanıtta gerçekten dönen PublicGuides ve PublicGuide tabloları gösterilir.

UYUMLULUK

• Yanıt gövdesi değişmedi; programNumber mevcut entegrasyonlarda zaten bulunuyordu. Alanı nullable integer olarak ele alın.
• Acentanın numaralandırma başlangıç ayarı veya iç sayaç bilgisi API üzerinden yayınlanmaz.

Partner API v1.5.4

28 Eylül 2026 — Dönüş Uçuşu Segmenti Doğrulaması

transport.flights[].return yalnızca gerçek dönüş uçuşu bilgisi veya kayıtlı bir dönüş havalimanı olduğunda döner.

DÜZELTME

• return segmenti artık yalnızca gidiş havalimanlarından türetilmez. Dönüş uçuş numarası, dönüş tarihi, geçerli HH:MM dönüş saati veya en az bir kayıtlı dönüş havalimanı gerekir.
• Gidiş rotasının tersiyle tamamlama yalnızca dönüş uçuş bilgisi varsa uygulanır; kayıtlı dönüş havalimanı her zaman korunur.
• Dönüş uçuş bilgisi olmadan yalnızca bir dönüş havalimanı kayıtlıysa eksik taraf (return.origin veya return.destination) null döner.
• HH:MM formatında olmayan dönüş saati değerleri dönüş uçuşu bilgisi sayılmaz ve return.arrivalTime olarak yayınlanmaz.

UYUMLULUK

• Dönüş uçuş bilgisi olan gidiş-dönüş kayıtları önceki gibi davranır.
• Yalnızca gidiş bilgisi olan uçuşlarda yanıltıcı return segmenti artık yer almaz; return alanını opsiyonel ele alın.

Partner API v1.5.3

28 Eylül 2026 — Dönüş Rotası Kaynağı (routeInferred)

Dönüş segmentine rotanın kayıtlı mı yoksa tamamlanmış mı olduğunu belirten alan eklendi.

YENİ

• transport.flights[].return.routeInferred (boolean): false yalnızca dönüş kalkış ve varış havalimanlarının ikisi de açıkça kayıtlıysa; aksi halde true.
• return segmenti yoksa alan dönmez; outbound segmentinde yer almaz.

UYUMLULUK

• Additive ve backward-compatible; return.origin / return.destination değerleri değişmedi.

Partner API v1.5.2

28 Eylül 2026 — Açık Dönüş Havalimanları

Acenteler dönüş uçuşunun kalkış ve varış havalimanlarını ayrıca kaydedebilir; API bu değerleri yayınlar.

YENİ

• Kayıtlı dönüş havalimanları varsa transport.flights[].return.origin / return.destination gidiş rotasının tersi yerine bu değerlerden gelir.
• Farklı havalimanından dönüş yapılan (open-jaw) programlar doğru rota ile yayınlanır.

UYUMLULUK

• Dönüş havalimanı kaydı olmayan eski uçuşlarda gidiş rotasının tersi kullanılmaya devam eder (1.5.4 ile dönüş uçuş bilgisi şartına bağlandı).
• Transfer hizmeti alanları değişmedi.

Partner API v1.5.1

25 Eylül 2026 — Transfer Alanları Dokümantasyonu

Uçuş transfer hizmeti alanları OpenAPI sözleşmesinde zorunlu alanlar olarak belgelendi.

YENİ

• ProgramFlight: hasTransfer, transferPricingType, transferPrice ve transferCurrency zorunlu alanlar olarak belgelendi.
• Transfer yok / ücretsiz / ücretli yanıt örnekleri eklendi.

UYUMLULUK

• Yalnızca dokümantasyon; yanıt şekli değişmedi.

Partner API v1.5.0

24 Eylül 2026 — Aktarma Alanları Kaldırıldı

Eski aktarmalı uçuş modeline ait alanlar kaldırıldı; program uçuşları güncel uçuş kaydından okunur.

DÜZELTME

• Program detayındaki uçuşlar ve transfer hizmeti alanları güncel uçuş kaydından tutarlı şekilde döner.

KALDIRILDI

• transport.flights[].connectionType
• transport.flights[].transferAirport
• transport.flights[].transferFlightNo

UYUMLULUK

• Breaking: kaldırılan alanları okuyan entegrasyonlar güncellenmelidir. Havalimanı transfer hizmeti için hasTransfer / transferPricingType kullanın.

Partner API v1.4.4

24 Eylül 2026 — Transfer Para Birimi

Ücretli transfer hizmeti için para birimi eklendi.

YENİ

• transport.flights[].transferCurrency: USD | EUR | SAR | TRY.

UYUMLULUK

• Additive. Para birimi kaydı olmayan eski ücretli transferlerde USD döner.

Partner API v1.4.3

24 Eylül 2026 — Transfer Hizmeti Alanları

Uçuşlara havalimanı transfer hizmeti bilgisi eklendi.

YENİ

• transport.flights[].hasTransfer, transferPricingType (free | paid) ve transferPrice.

UYUMLULUK

• Additive. Transfer kaydı olmayan eski uçuşlarda hasTransfer: false döner.

Partner API v1.4.2

24 Eylül 2026 — Aktarma Bilgisi

Uçuşlara aktarma bilgisi eklendi.

YENİ

• transport.flights[].connectionType (direct | connecting), transferAirport, transferFlightNo.

UYUMLULUK

• Bu alanlar 1.5.0 ile kaldırıldı.

Partner API v1.4.1

24 Eylül 2026 — Havayolu Logo Adresleri

Havayolu logo URL'leri barındırılan SVG dosyalarına yönlendirildi.

DÜZELTME

• transport.flights[].airline.logoUrl artık /v1/assets/airlines/{id}.svg altındaki erişilebilir dosyalara işaret eder.
• Bilinmeyen havayolları için logoUrl: null döner; kırık URL üretilmez.

UYUMLULUK

• Alan adı ve şekli aynı; eski thy.svg / suud.svg adresleri çalışmaya devam eder.

Partner API v1.4

22 Eylül 2026 — Tarih Doğruluğu ve Public Rehberler

Tarih alanları Türkiye takvim gününe göre düzeltildi; rehber bilgisi public tanıtım alanından yayınlanır.

YENİ

• guides.male / guides.female: name, title?, photoUrl?

DÜZELTME

• departureDate, returnDate, hotels[].checkIn / checkOut ve uçuş departureDate alanları Türkiye takvim gününü (YYYY-MM-DD) korur; UTC kayması ile bir gün geri gitmez.

KALDIRILDI

• guide
• staff

UYUMLULUK

• Breaking: guide / staff yerine guides kullanın.
• date-time alanlar (departureDateTime) ISO 8601 UTC olarak kalır.

GÜVENLİK

• Operasyonel rehber ve personel bilgisi public API'den çıkarıldı.

Partner API v1.3

22 Eylül 2026 — Program Tanıtım Alanları

Program tanıtım sayfası için gereken alanlar tamamlandı.

YENİ

• programNumber (public program numarası)
• content.programDescription
• hotels[].destination (makkah | madinah) ve hotels[].duration
• hotels[].coverUrl / hotels[].galleryUrls
• transport.flights[].airline.name
• transport.flights[].outbound / transport.flights[].return
• Pegasus (PC) havayolu logosu

UYUMLULUK

• Additive ve backward-compatible; mevcut alanlar kaldırılmadı.

Partner API v1.2

19 Eylül 2026 — Program Detayları Genişletildi

Program API'si public/tanıtım amaçlı program bilgileriyle genişletildi.

YENİ

• gün/gece bilgisi
• başlayan fiyat
• kategori
• rehber/hoca public bilgileri
• otel yıldız seviyesi
• özel program etiketleri
• kapak ve galeri
• dahil/hariç hizmetler
• public seyahat güzergahı
• gezi yerleri
• konaklama açıklaması
• program FAQ
• uçuş/airline public bilgileri

UYUMLULUK

• Bu release additive ve backward-compatible.
• Mevcut /v1 endpointleri değişmedi.
• Mevcut response alanları kaldırılmadı.
• Yeni alanlar optional/nullable olabilir.

GÜVENLİK

• Ham dailyPlan yayınlanmaz.
• PII/internal IDs yayınlanmaz.
• Operasyonel otel notları/telefon/adres yayınlanmaz.

Partner API v1.0.1

17 Eylül 2026 — Canonical API host

Dedicated Hosting site sefera-api rewrites /v1/** to partnerApiV1. Custom domain api.sefera.com.tr.

Partner API v1.0.0

17 Eylül 2026 — Partner API V1

Production Partner API V1.

YENİ

• Canonical GET /v1/programs and GET /v1/programs/{programId}
• Explicit public DTOs (allowlist). Raw tour documents are never serialized.
• Server-side capacity snapshot
• Per-token rate limit (429 rate_limit_exceeded)
• Stable error envelope { error: { code, message }, requestId }
• Legacy GET /api/v1/partner/programs kept for existing partner integrations