# Hız Sınırları & Kotalar
SUMMARY: Synapse API için hız sınırı politikaları — Bearer header (sınırsız), ?key= (60/dakika), herkese açık uç noktalar.

KEY CONTEXT:
Mind Key (Authorization: Bearer header) → NO rate limit
Mind Key (?key= query param) → 60 req/min per IP
JWT (Authorization: Bearer header) → NO rate limit
Public endpoints (/tools/*, /docs, /health, /endpoints) → NO rate limit
Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After
Recommendation: ALWAYS use Authorization header. Use ?key= only for URL-only tools.

Hız Sınırları & Kotalar
Synapse, kötüye kullanımı önleyen ve aynı zamanda meşru kullanımın önüne geçmeyen basit, öngörülebilir bir hız sınırı politikasına sahiptir.
Hız Sınırı Politikası
| Kimlik Doğrulama Yöntemi | Sınır | Kapsam |
|-------------|-------|-------|
| Mind Key () | Yok | Mind başına |
| Mind Key () | 60 istek/dakika | IP başına |
| JWT () | Yok | Kullanıcı başına |
| Herkese açık uç noktalar | Yok | Global |
> [!TIP]
> Mümkün olduğunda daima  başlığını kullanın. Hız sınırı yoktur.  seçeneğini yalnızca özel başlık ayarlayamayan araçlar için kullanın.
Hız Sınırı Başlıkları
 kimlik doğrulaması kullandığınızda, yanıtlar hız sınırı başlıklarını içerir:
[CODE BLOCK]
Sınırı aştığınızda:
[CODE BLOCK]
Hız Sınırına Ulaştığınızda
429 alırsanız:
1. Authorization header'a geçin (önerilir):
   [CODE BLOCK]
2. Veya  saniye bekleyin ve yeniden deneyin.
?key= Sınırı Neden Var
 sorgu parametresi yalnızca URL kullanan araçlar (tarayıcılar,  komutları) için uygundur, ancak güvenlik ve performans etkileri vardır:
- Güvenlik: Sorgu parametreleri sunucu erişim günlüklerinde, tarayıcı geçmişinde ve Referer başlıklarında kaydedilir. Kullanımı sınırlamak maruziyeti azaltır.
- Performans: Sorgu parametresi kimlik doğrulaması, IP tabanlı bir hız sınırlayıcı gerektirir (istek başına Redis araması), bu da gecikme ekler. Header kimlik doğrulaması bunu atlar.
- Kötüye kullanım önleme: Sızdırılmış bir  URL'si paylaşılabilir ve kötüye kullanılabilir. IP sınırı etki alanını sınırlar.
Önerilen Desenler
LLM ajanları
[CODE BLOCK]
Tarayıcı tabanlı araçlar
Aracınız yalnızca URL açabiliyorsa:
[CODE BLOCK]
MCP sunucusu
MCP sunucuları her zaman  env değişkeni üzerinden header kimlik doğrulaması kullanır — hız sınırı uygulanmaz.
Toplu içe aktarımlar
Toplu işlemler (örn. 1000 bellek içe aktarma) için her zaman header kimlik doğrulaması kullanın.  üzerinden toplu içe aktarımlar 1 dakika içinde hız sınırına takılır.
Kotalar (Mind Düzeyi)
Şu anda depolama boyutu veya bellek sayısı için mind başına kota yoktur. Tüm sınırlar veri düzeyinde değil, kimlik doğrulama/IP düzeyindedir. Bu, çok kiracılı adillik için gelecekte değişebilir.
Kullanımınızı İzleme
[CODE BLOCK]
Sonraki Adımlar
- Kimlik Doğrulama
- Hatalar & Hata Yönetimi