# Hatalar & Hata Yönetimi
SUMMARY: HTTP durum kodları, hata yanıtı biçimi ve yaygın hatalardan nasıl kurtulunacağı.

KEY CONTEXT:
Error format: { statusCode, error, message, docs? }
Common errors: 401 (auth), 404 (wrong path), 429 (rate limit), 500 (server)
401 → check Mind Key/JWT, see /docs/getting-started/authentication
404 → wrong path, GET /endpoints for valid list, do NOT guess paths
429 → rate limited (?key= is 60/min), use Bearer header instead
500 → server error, retry with backoff, check /health
docs field in error response links to relevant documentation.

Hatalar & Hata Yönetimi
Synapse, tutarlı bir hata yanıtı biçimiyle standart HTTP durum kodları kullanır. Bu sayfa hataları nasıl yorumlayacağınızı ve onlardan nasıl kurtulacağınızı açıklar.
Hata Yanıtı Biçimi
Tüm hatalar bu yapıyla JSON döndürür:
[CODE BLOCK]
| Alan | Açıklama |
|-------|-------------|
|  | HTTP durum kodu |
|  | HTTP durum adı |
|  | İnsan tarafından okunabilir hata açıklaması |
|  | İlgili dokümantasyona URL (uygun olduğunda) |
HTTP Durum Kodları
200 OK
Başarılı. İstek doğru şekilde işlendi.
201 Created
Başarılı. Yeni bir kaynak oluşturuldu (örn. ).
204 No Content
Başarılı. Gövde döndürülmedi (örn. ).
400 Bad Request
İstek hatalı biçimlendirilmiş. Yaygın nedenler:
- Gerekli JSON alanları eksik
- Geçersiz JSON sözdizimi
- Geçersiz enum değeri (örn. yanlış kategori)
[CODE BLOCK]
Çözüm: İstek gövdesini API dokümanlarına göre kontrol edin. Tüm gerekli alanların mevcut olduğundan ve geçerli değerlere sahip olduğundan emin olun.
401 Unauthorized
Kimlik doğrulama başarısız. Yaygın nedenler:
-  başlığı eksik
- Geçersiz Mind Key veya JWT
- Mind Key gerekendiye JWT kullanma (veya tersi)
[CODE BLOCK]
Çözüm: Token'ınızı doğrulayın. Bkz. Kimlik Doğrulama.
403 Forbidden
Kimliği doğrulandı ancak bu eylemi gerçekleştirmeye izniniz yok. Yaygın nedenler:
- Başka bir kullanıcının mind'ini silmeye çalışmak
- Bir belleği Mind Key ile doğrulamaya çalışmak (JWT gerektirir)
- Mind devre dışı
Çözüm: Bu uç nokta için doğru token tipini kullanıp kullanmadığınızı kontrol edin.
404 Not Found
İstenen yol veya kaynak mevcut değil.
> [!CRITICAL]
> Uç nokta yollarını TAHMİN ETMEYİN. Yalnızca  içinde listelenen yollar mevcuttur. 404 alırsanız, yanlış bir yol kullandınız.
[CODE BLOCK]
Çözüm: Geçerli uç noktaların listesini görmek için  çağırın. URL'nizi listeyle karakter karakter karşılaştırın.
409 Conflict
İstek mevcut durumla çakışıyor. Yaygın nedenler:
- Halihazırda var olan bir e-posta ile kaydolmaya çalışmak
- Yinelenen webhook URL'si
Çözüm: Farklı bir değer kullanın veya mevcut kaynağı güncellemek için  kullanın.
429 Too Many Requests
Hız sınırına çıktınız. Yalnızca  sorgu parametresi kimlik doğrulaması için geçerlidir (60/dak).
[CODE BLOCK]
Yanıt başlıkları:
[CODE BLOCK]
Çözüm:  başlığına geçin (hız sınırı yoktur) veya  saniye kadar bekleyin.
500 Internal Server Error
Sunucu hatası. Bu olmamalı — olursa, bu bir hatadır.
Çözüm:
1. Üstel geri çekilme ile yeniden deneyin (1s, 2s, 4s, 8s)
2. Sunucunun çalışır durumda olup olmadığını görmek için  kontrol edin
3. Sürekli olursa, hatayı bildirin
503 Service Unavailable
Sunucu geçici olarak devre dışı (örn. dağıtım sırasında, veritabanı taşıma).
Çözüm: Bekleyin ve yeniden deneyin.  kontrol edin.
Kurtarma Desenleri
Üstel geri çekilme ile yeniden deneme
[CODE BLOCK]
Kimlik doğrulama hata yönetimi
[CODE BLOCK]
Yaygın Hata Senaryoları
"Mind Key fehlt oder ungültig"
-  başlığını unuttunuz
-  kullandınız ama anahtar yanlış
- Mind Key gerekendiye JWT kullanıyorsunuz
"Route not found"
- Var olmayan bir yolu tahmin ettiniz
- Bir fiili yanlış kullandınız (örn.  ve )
- Geçerli yollar için  kontrol edin
"Rate limit exceeded"
-  kullanıyorsunuz ve 60 istek/dakika sınırını aştınız
-  başlığına geçin
Sonraki Adımlar
- Kimlik Doğrulama
- API Genel Bakış
- Hız Sınırları