Genel Hata Modeli & Kodlar

Açıklama

Tüm HPM servisleri, Finrota API mimarisi ile uyumlu standart bir hata yapısı kullanır.

Genel alanlar:

• statusCode – İşlemin durumunu temsil eden kod (ör. 200, 400, 401, 500 vb.)

• message – İnsan tarafından okunabilir özet mesaj.

• errors / exceptions – Detaylı hata listesi veya istisna bilgileri (varsa).

Yaygın HTTP Kodları

Kod	Anlamı
200	OK → İşlem başarılı, sonuç döndü.
201	Created → Yeni bir kaynak oluşturuldu (HPM için tipik değil).
400	Bad Request → Zorunlu alan eksik, format hatası vb.
401	Unauthorized → Token eksik veya geçersiz.
403	Forbidden → Servis yetkisi / lisans yok.
404	Not Found → İlgili kayıt / kaynak bulunamadı.
409	Conflict → Çakışan durum (ör. aynı clientOrderReference kuralına bağlı senaryolar vb.).
422	Unprocessable Entity → Validasyon hataları (alan bazlı).
429	Too Many Requests → Dakika/istek limitleri aşıldı.
500	Internal Server Error → Genel sunucu hatası.
503	Service Unavailable → Servis geçici olarak kullanılamıyor.