Serkan
API hata gövdelerimi RFC 7807 problem+json biçimine mi taşımalıyım?
7807 yerine onu güncelleyen RFC 9457'yi baz alın, üretimi tek bir exception handler'a toplayın ve `type` URI'sini sözleşme gibi yönetin.
Tüm sorular
Etiket
#API
REST ve modern API tasarımı: sözleşme, sürümleme, hata biçimi ve tüketim pratikleri. Bu etiketle sorulan sorular ve cevapları.
Bu etikette 4 cevaplanmış soru var.
Ece
OpenAPI şemasını önce mi yazmalıyım yoksa koddan mı üretmeliyim?
`openapi.yaml`'ı tek doğru kaynak yapıp contract-first gidin; drift'i bitiren şey yön değil, CI'da spec'i koda karşı doğrulayan yeşil contract testtir.
Burak
Public API'mde bir endpoint'i kullanımdan kaldırırken sunset sürecini nasıl yönetmeliyim?
Kullanımı partner bazında ölçün, her yanıta Sunset ve Deprecation başlığı koyun, tarihli sunset duyurup brownout yapın, kullanım sıfıra yaklaşınca kesin.
Sıla
Ödeme webhook'u aynı bildirimi tekrar gönderiyor; idempotency'i nasıl kurarım?
HMAC'i ham gövdede constant-time doğrulayın, hızlı 200 dönüp işi kuyruğa alın ve tekilliği event_id üzerindeki UNIQUE constraint'e yaptırın.