Sürümleme
API nesli, geriye uyumluluk kuralları ve kullanımdan kaldırma politikası.
Geçerli API nesli V4’tür. Uç nokta yolları sürüm öneki içermez; sürüm bir nesil etiketidir. Sürümleme yaklaşımı, mevcut entegrasyonları kırmadan API’nin gelişmesini sağlar.
Geriye uyumluluk
Eklemeli değişiklikler — yeni uç noktalar, yeni opsiyonel istek alanları, yeni yanıt alanları — kırıcı değildir ve V4 içinde yayınlanabilir. Kırıcı bir değişiklik yalnızca yeni bir ana nesil olarak sunulur.
İleriye uyumlu istemciler
Entegrasyonunuzu ileriye uyumlu yazın: bilinmeyen yanıt alanlarını yok sayın ve alan sırasına bağımlı olmayın. Bu şekilde yazılan bir istemci, eklemeli değişikliklerde çalışmaya devam eder.
openapi.json dosyasıdır ve her API değişikliğinden önce güncellenir.Kullanımdan kaldırma
Bir uç nokta veya alan kullanımdan kaldırılacağında, kaldırılmadan önce duyurulur. Mevcut entegrasyonlar, duyurulan geçiş süresi boyunca çalışmaya devam eder.