Genel Hata Modeli & Kodlar
Açıklama
Tüm Finrota CAT API servisleri standart bir hata mesajı formatı kullanır. Bu sayede hataları kolayca anlayıp çözebilirsiniz.
- Hata Formatı: Genellikle bir statusCode (HTTP hata kodu), error (hata türü), message (hatanın detayı)
- Sık Görülen HTTP Hataları:
- 200 OK: İşlem başarılı.
- 400 Bad Request: İstek hatalı veya eksik.
- 401 Unauthorized: AccessToken geçersiz veya eksik.
- 403 Forbidden: Bu işlemi yapmaya yetkiniz yok.
- 404 Not Found: Aradığınız kayıt bulunamadı.
- 409 Conflict: Çakışan bir durum var (örn. aynı ERP kodunu tekrar gönderme).
- 429 Too Many Requests: Belirlenen limitleri aştınız.
- 500 Internal Server Error: Sunucu tarafında genel bir hata oluştu.
Yaygın HTTP Kodları ve Anlamları
| Kod | Anlamı |
|---|---|
| 200 | OK → İşlem başarılı, sonuç döndü |
| 200 | OK + [] → İşlem başarılı ama eşleşen kayıt yok |
| 201 | Created → Yeni kayıt başarıyla oluşturuldu |
| 204 | No Content → İşlem başarılı, ancak gövde döndürülmedi |
| 400 | Bad Request → Parametre hatası veya geçersiz istek |
| 401 | Unauthorized → AccessToken eksik veya geçersiz |
| 403 | Forbidden → Yetki bulunmuyor |
| 404 | Not Found → İlgili kayıt bulunamadı |
| 409 | Conflict → Çakışan işlem (örn: aynı ERP kodu ikinci kez işaretleme) |
| 422 | Unprocessable Entity → Doğrulama hataları (eksik/yanlış alanlar) |
| 429 | Too Many Requests → Limit aşıldı (dakika/istek limitleri) |
| 500 | Internal Server Error → Genel sunucu hatası |
| 503 | Service Unavailable → Servis geçici olarak kullanılamıyor |