C# Academy · Ders

API Sürümleme Stratejileri

URL, üst bilgi ve sorgu dizesiyle sürümleme yapın.

API Sürümleme Stratejileri, CoddyKit'te ücretsiz bir C# Academy dersidir. Bu, 4 dersinin 1. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, C# Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. C# Academy kursu toplamda 4 dersten oluşur.

API Neden Sürümlendirilmeli

İstemcileriniz API'nize bağımlı hâle geldiğinde sözleşmesini bozamazsınız. Sürümleme, eski istemciler eski sürümle çalışmaya devam ederken geriye dönük uyumsuz değişiklikleri yeni bir sürümde yayımlamanızı sağlar.

// v1 returns { name }
// v2 returns { firstName, lastName }  (breaking)

URL Yolu Sürümlemesi

En görünür stratejide sürüm yola eklenir. Bu yöntem belirsizliği ortadan kaldırır; yönlendirmesi, incelenmesi ve önbelleğe alınması kolaydır.

GET /api/v1/products
GET /api/v2/products

Sorgu Dizesi Sürümlemesi

Sürüm bir sorgu parametresi olarak taşınır. URL'ler sabit kalır ve eksik parametre en yeni veya sabit bir sürüme varsayılan olabilir.

GET /api/products?api-version=1.0
GET /api/products?api-version=2.0

Üstbilgi Sürümlemesi

Özel bir istek üstbilgisi sürümü taşır ve URL'yi temiz tutar. Dezavantajı, tarayıcının adres çubuğunda görünmemesi ve elle sınanmasının daha zor olmasıdır.

GET /api/products
X-Api-Version: 2.0

Medya Türü Sürümlemesi

İçerik anlaşması olarak da adlandırılır. Sürüm, Accept üstbilgisinin medya türüne gömülür. REST'e en uygun, ancak keşfedilebilirliği en düşük seçenektir.

GET /api/products
Accept: application/json;v=2.0

Stratejileri Karşılaştırma

Her strateji keşfedilebilirlik ile URL temizliği arasında bir seçim yapar:

URL yolu: en keşfedilebilir seçenektir, URL'leri kalabalıklaştırır.
Sorgu dizesi: sabit URL'ler ve kolay varsayılanlar sağlar.
Üstbilgi: temiz URL'ler sağlar, tarayıcılarda gizlidir.
Medya türü: REST açısından en saf seçenektir, kullanımı en zordur.

// Many teams pick URL path for public APIs

API'lerde Anlamsal Sürümleme

API sürümleri genellikle yalnızca ana sürüm biçimindedir (v1, v2). Alt sürümleri, eski istemcilerin yok sayabileceği eklemeli ve geriye dönük uyumlu değişiklikler için ayırın.

// v1.0 -> v1.1 : additive (safe)
// v1   -> v2   : breaking (new version)

Kullanımdan Kaldırma

Eski bir sürümü hiçbir zaman aniden kaldırmayın. Onu kullanımdan kaldırılmış olarak işaretleyin, sonlandırma tarihini duyurun ve üstbilgiler aracılığıyla istemcilere bildirin.

// Response header on a deprecated version:
// Sunset: Wed, 31 Dec 2026 23:59:59 GMT
// Deprecation: true

Varsayılan Sürüm

Bir istemci sürüm göndermediğinde ne olacağına karar verin. Yaygın seçenekler şunlardır: en yeni sürümü varsaymak, v1'i varsaymak veya isteği reddetmek. Açık davranmak sürprizleri önler.

// Strategy: unversioned request -> treat as v1.0

Doğru Şeyleri Sürümleme

İç uygulama ayrıntılarını değil, sözleşmeyi (rotaları, istek/yanıt biçimlerini) sürümleyin. v2 uç noktası, iş mantığının çoğunu v1 ile paylaşabilir.

// Same service, two thin controllers:
// ProductsV1Controller, ProductsV2Controller

Stratejileri Birlikte Kullanma

ASP.NET Core'un sürümleme kitaplığı, sürümü aynı anda birkaç kaynaktan okuyabilir ve istemcilerin kendileri için uygun olanı seçmesine olanak tanır. Bunu sonraki bölümde yapılandıracaksınız.

// Accept version from URL OR header OR query

Hızlı Kontrol

Sürümleme stratejileri hakkındaki anlayışınızı sınayın.

Özet

API sürümleme stratejilerini incelediniz:

URL yolu, sorgu dizesi, üstbilgi ve medya türü.
Her biri keşfedilebilirlik ile URL temizliği arasında bir seçim yapar.
Sözleşmeyi sürümleyin, kullanımdan kaldırma işlemini kademeli yapın ve bir varsayılan belirleyin.

Sırada: ASP.NET Core'da Asp.Versioning yapılandırması.

Sıkça Sorulan Sorular

“API Sürümleme Stratejileri” dersi ücretsiz mi?

Evet — “API Sürümleme Stratejileri” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve C# Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. C# Academy kursu toplamda 4 dersten oluşur.

“API Sürümleme Stratejileri” dersinde ne öğreneceğim?

URL, üst bilgi ve sorgu dizesiyle sürümleme yapın. C# Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

C# Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te C# Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 1. dersidir.

“API Sürümleme Stratejileri” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu C# Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her C# Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← C# Academy Sayfasına Dön