API Versiyon Stratejisi

Bu doküman, ürün perspektifinden API versiyonlama yaklaşımımızı açıklar.

Genel Bakış

API versiyonlama, geriye dönük uyumluluğu korurken inovasyonu mümkün kılmak için kritik önem taşır. Bu strateji Mühendislik API Standartlarımız ile uyumludur.

Versiyon Yaşam Döngüsü

1. Geliştirme (v0.x)

   • Beta özellikler
   • Kararlılık garantisi yok
   • İç testlerle sınırlı

2. Kararlı (v1.x+)

   • Üretime hazır
   • Sadece geriye dönük uyumlu değişiklikler
   • Güvenlik güncellemeleri

3. Kullanımdan Kaldırma

   • 6 aylık bildirim süresi
   • Geçiş kılavuzları sağlanır
   • Sadece kritik düzeltmeler için destek

Versiyon Destek Politikası

• Ana versiyonlar için minimum 12 ay destek
• Güvenlik yamaları 18 ay boyunca
• Ana versiyon yükseltmeleri için geçiş araçları sağlanır

Ürün Gereksinimleri

API değişikliği talep ederken:

1. Geriye dönük uyumluluk gereksinimlerini belirtin
2. Geçiş yollarını dokümante edin
3. Kullanımdan kaldırma zaman çizelgesini tanımlayın
4. İş gerekçesini sağlayın

İletişim Planı

• API yanıtları üzerinden kullanımdan kaldırma bildirimleri
• Kayıtlı geliştiricilere e-posta bildirimleri
• Dokümantasyon güncellemeleri
• Geçiş kılavuzları ve destek