API değişiklikleri
Uyumu bozan değişiklikler, kullanımdan kaldırmalar ve sürümleme, etkilenen kişilere anlatılmış hâliyle.
-
Stripe API versiyonlama: nasıl çalışır, neler kopyalanır
Stripe API versiyonlama hesabı tarihli bir sürüme sabitler, her istek bunu ezebilir. Nasıl çalıştığı, maliyeti ve küçük bir API'nin kopyalayabilecekleri.
API değişiklikleri6 dk okuma
-
Protobuf breaking change'leri: wire'da neler hayatta kalır
Protobuf breaking change'leri URL'de değil, wire'da olur. Bazı alan değişiklikleri ücretsizdir, diğerleri her client'ı sessizce bozar, diff'te aynıdır.
API değişiklikleri5 dk okuma
-
Versiyon numarası olmadan GraphQL deprecation
GraphQL'de URL'de v1 veya v2 yok. Alanlar paylaşılan tek şema üzerinde, bir direktifle tek tek deprecate edilir ve bu changelog'un borcunu değiştirir.
API değişiklikleri5 dk okuma
-
API geçiş kılavuzu nasıl yazılır
API geçiş kılavuzu, uyumsuz bir değişikliği kesintiye değil kontrol listesine dönüştürür. Neye ihtiyacı var, ve neden tek başına bir giriş yetmez.
API değişiklikleri4 dk okuma
-
Dahili API changelog'ları: diğer ekip için ne değişir
Genel bir API changelog'unun doğrudan ulaşamayacağınız bir kitlesi vardır. Dahili olanın kitlesi iki kat öteden gelir ve ona borcunuzu değiştirir.
API değişiklikleri4 dk okuma
-
Webhook changelog'ları: kimsenin istemediği breaking change
Bir webhook payload değişikliği sessizce bozulur, çünkü onu reddedecek bir çağıran yoktur. Neyin breaking sayıldığı ve payload'ın nasıl versiyonlanacağı.
API değişiklikleri4 dk okuma
-
API sunset header'ı: ne zaman gönderilir
API sunset header'ı, deprecation'ın aksine, bir sürümün ne zaman yanıt vermeyi durduracağını söyler. RFC 8594 neyi kapsar, brownout ne kazandırır.
API değişiklikleri4 dk okuma
-
API changelog: neyi yayınlamalı, kim okur
Bir API changelog'unu, kodunun gelecek ay hala çalışıp çalışmayacağına karar veren kişiler okur. Her kaydın onlara borcu, yeri ve abonelik yolu.
API değişiklikleri5 dk okuma
-
Geliştiricileri kaybetmeden bir API nasıl deprecate edilir
Deprecation, üzerinde tarih olan bir sözdür. Zaman çizelgesi, bildirim şablonu, yanıt başlıkları, ve bir sunset'in olaya dönüşmesini durduran adım.
API değişiklikleri5 dk okuma
-
Çağıranlar için API versiyonlama en iyi uygulamaları
Sadece bozan şeyi versiyonlayın, versiyonu çağıranların görebileceği yere koyun, ve eskisini bir tarihe kadar çalışır tutun. Dört şema karşılaştırıldı.
API değişiklikleri6 dk okuma
-
Breaking change: ne sayılır ve nasıl gönderilir
Breaking change, doğru bir çağıranın hayatta kalamayacağı değişikliktir. Ne sayılır, ne sayılmaz, CI'da nasıl yakalanır ve güvenle nasıl gönderilir.
API değişiklikleri8 dk okuma
