Hata Kodları
Hatalar standart HTTP durum kodları ve gövdedeki error.code / error.message ile iletilir.
{
"success": false,
"error": { "code": "VALIDATION", "message": "E-posta zorunludur" }
}
HTTP durum kodları
| Durum | Anlamı |
|---|
200 / 201 | Başarılı — kaynak döner veya oluşturulur. |
400 | Geçersiz istek (eksik/hatalı alan). |
401 | Kimlik doğrulama gerekli veya token geçersiz/süresi dolmuş. |
403 | Yetki yok (rol/izin veya kurum üyeliği yetersiz). |
404 | Kaynak bulunamadı. |
409 | Çakışma (ör. mükerrer kayıt). |
422 | Doğrulama hatası (iş kuralı ihlali). |
429 | Hız limiti aşıldı — bir süre sonra tekrar deneyin. |
500 | Sunucu hatası. |
Standart error.code değerleri
| Kod | Anlamı |
|---|
VALIDATION | Girdi doğrulaması başarısız. |
UNAUTHORIZED | Oturum/token gerekli veya geçersiz. |
FORBIDDEN | İşlem için yetki yok. |
NOT_FOUND | Kaynak bulunamadı. |
NOT_MEMBER | Belirtilen kuruma erişim yetkiniz yok. |
TOO_MANY_ATTEMPTS | Çok fazla başarısız deneme — geçici kilit. |
INTERNAL_ERROR | Beklenmeyen sunucu hatası. |
error.message son kullanıcıya gösterilebilecek Türkçe bir açıklamadır; program akışında error.code değerini esas alın.