.NET Core Web API: API Versioning

Bu video, ASP.NET Core Web API projelerinde API versiyonlamanın (versioning) neden gerekli olduğunu, stratejilerini ve pratik uygulamalarını detaylıca ele alıyor (0:00-14:09).

Öne Çıkan Başlıklar:

• Neden Versiyonlama Gerekli?: API tüketen istemcileri (mobil, web, partnerler) kırmadan yeni özellikler sunmak ve geçiş süreci yönetmek için kritik öneme sahiptir (0:45-1:20).
• Breaking Change (Kırıcı Değişiklikler): Bir API'da alan adı değişikliği, tip değişikliği veya route değişikliği gibi istemciyi doğrudan etkileyen durumlar "breaking change" olarak adlandırılır ve yeni bir ana sürüm (major version) gerektirir (1:36-2:30).
• Sürümleme Stratejileri:
  • URL Segment: /api/v1/... (En belirgin ve yaygın yöntem) (3:07-3:29).
  • Query String: ?api-version=1.0 (3:29-4:07).
  • Header: X-Api-Version (4:07-4:39).
• Uygulama ve Swagger:
  • Projeye Microsoft.AspNetCore.Mvc.Versioning ve ApiExplorer paketlerinin eklenmesi gerektiği vurgulanıyor (9:39-9:50).
  • Program.cs içerisinde AddApiVersioning konfigürasyonları ve varsayılan sürüm ayarları gösteriliyor (10:00-10:55).
  • Swagger üzerinde versiyonların (v1, v2) ayrı gruplar halinde dokümante edilmesi ve test edilmesi anlatılıyor (11:19-13:25).

Video, sürümlemenin sadece bir kodlama tercihi değil, aynı zamanda diğer ekiplerle uyumlu çalışma ve projenin sürdürülebilirliği için bir gereklilik olduğunu savunarak sona eriyor (13:30-14:09).