Her endpoint farklı bir hata formatı döndürüyorsa client'lar her biri için ayrı kod yazar. Problem Details standardı, hata kodları ve doğrulama hatalarının tasarımı.
YAZILAR / NOTLAR
Kategori: API Tasarımı
Yazılım geliştirme, sistem tasarımı ve karşılaştığım teknik sorunlar üzerine notlar.
Her istekte aynı JSON'u baştan üretip göndermek gereksiz. API'lerde Cache-Control, ETag ve 304 Not Modified ile bant genişliği ve sunucu yükü nasıl azaltılır?
/v2 açmak çoğu zaman problemi çözmez, sadece ertelemeye yarar. Hangi değişiklik breaking change sayılır, tolerant reader nedir ve API nasıl kırmadan evrilir?
Kullanıcı çıkış yaptı ama token hâlâ geçerli. JWT'nin stateless yapısı iptal gerektiğinde nasıl yönetilir? Kısa ömürlü access token, refresh rotation ve denylist.
İlk sayfalar hızlı, binlerce sayfa sonrası ise sorgu saniyeler sürüyor. Offset pagination'ın maliyeti, keyset pagination ve cursor tabanlı API tasarımı.
.env dosyası commit edildi, sonra silindi. Ama anahtar hâlâ git geçmişinde. Secret sızıntısı olduğunda doğru tepki, rotation ve secret'ları koddan ayırmanın yolları.
Webhook endpoint'i kapalıysa olay kaybolur mu? Aynı event iki kez gelirse ne olur? Webhook gönderen ve alan taraf için imzalama, retry ve idempotency.
Fixed window, sliding window, token bucket. Rate limiting algoritmasını seçmek kadar limitin kime, nerede ve nasıl uygulanacağı da önemli. Pratik bir bakış.