Genel Hata Modeli & Kodlar
Açıklama
Tüm servislerde hata durumlarında standart bir JSON hata modeli döndürülür.
Bu model sayesinde istemci (client) uygulamalar hata tipini kolayca ayırt edebilir ve uygun aksiyonu alabilir.
Hata Modeli Formatı
{
"isSuccess": false,
"errorCode": "ERR_VALIDATION",
"message": "Zorunlu alan eksik veya format hatalı.",
"details": {
"field": "email",
"reason": "Geçerli bir e-posta adresi girilmelidir."
},
"timestamp": "2025-10-13T10:15:30Z",
"traceId": "f6b71239-8cfa-49de-8b5f-53f9fbd173a4"
}
| Alan Adı | Tip | Açıklama |
|---|---|---|
| isSuccess | boolean | İşlemin başarılı olup olmadığını belirtir. |
| errorCode | string | Sistem tarafından belirlenen hata kodu. (örn. ERR_UNAUTHORIZED, ERR_VALIDATION) |
| message | string | Kullanıcıya gösterilebilecek açıklama mesajı. |
| details | object | (Opsiyonel) Hata detaylarını alan bazında açıklar. |
| timestamp | datetime | Hatanın oluştuğu zaman (UTC). |
| traceId | string | Loglama veya hata takibi için benzersiz işlem kimliği. |
Genel Hata Kodları
| HTTP Kodu | Hata Kodu | Açıklama | Önerilen Çözüm |
|---|---|---|---|
| 400 | ERR_VALIDATION | Geçersiz veya eksik parametre. | Alan tiplerini ve zorunluluk durumlarını kontrol edin. |
| 401 | ERR_UNAUTHORIZED | Geçersiz AccessToken veya token süresi dolmuş. | Yeniden AccessToken alın. |
| 403 | ERR_FORBIDDEN | Kullanıcının bu işlemi yapma yetkisi yok. | Kullanıcı rolü veya yetki setini kontrol edin. |
| 404 | ERR_NOT_FOUND | İstenen kayıt veya kaynak bulunamadı. | Gönderilen code / erpCode değerini doğrulayın. |
| 409 | ERR_CONFLICT | Aynı benzersiz değer sistemde mevcut. | code veya erpCode başka kayıtla çakışıyor olabilir. |
| 500 | ERR_INTERNAL | Sunucu tarafında beklenmeyen bir hata oluştu. | Loglar veya traceId üzerinden teknik ekiple iletişime geçin. |