Hatalar

Tüm hatalar aynı gövdeyle döner: bir insan mesajı (message) ve makinenin dallanacağı sabit bir kod (code).

{
  "message": "Token geçersiz ya da süresi dolmuş",
  "code": "invalid_token"
}

Mesajı loglayabilir, kullanıcıya gösterebilirsin; ama akış kararını code üzerinden ver, message değişebilir.

Durum kodları

HTTP	Ne zaman
400	Geçersiz istek (eksik/yanlış alan)
401	Kimlik yok ya da geçersiz token
403	Kimlik var ama yetki/scope yetmiyor
404	Kayıt yok (ya da erişimin yok, ayrım sızdırılmaz)
409	Çakışma (ör. zaten var, kapasite enterprise ölçeği)
429	Hız limiti aşıldı: Retry-After başlığına bak
5xx	Bizde bir sorun: aynı isteği geri çekilerek yinele

Sık kodlar

code	Anlamı
validation_failed	Gövde doğrulaması geçmedi
invalid_token	Token geçersiz/süresi dolmuş
forbidden	Scope ya da rol yetmiyor
not_found	Kayıt bulunamadı
rate_limited	Hız limiti

Yeniden deneme

429 ve 5xx geçicidir; üstel geri çekilmeyle (exponential backoff) yinele. 4xx (429 hariç) kalıcıdır, isteği düzeltmeden yineleme.