{"title":"Hız Sınırları & Kotalar","slug":"rate-limits","category":"api","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.","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":311,"read_minutes":2,"llm_context":"Mind Key (Authorization: Bearer header) → NO rate limit\nMind Key (?key= query param) → 60 req/min per IP\nJWT (Authorization: Bearer header) → NO rate limit\nPublic endpoints (/tools/*, /docs, /health, /endpoints) → NO rate limit\nRate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After\nRecommendation: ALWAYS use Authorization header. Use ?key= only for URL-only tools.\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Hız Sınırları & Kotalar\n\nSynapse, 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.\n\n## Hız Sınırı Politikası\n\n| Kimlik Doğrulama Yöntemi | Sınır | Kapsam |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **Yok** | Mind başına |\n| Mind Key (`?key=`) | 60 istek/dakika | IP başına |\n| JWT (`Authorization: Bearer`) | **Yok** | Kullanıcı başına |\n| Herkese açık uç noktalar | **Yok** | Global |\n\n> [!TIP]\n> Mümkün olduğunda **daima `Authorization: Bearer` başlığını kullanın**. Hız sınırı yoktur. `?key=` seçeneğini yalnızca özel başlık ayarlayamayan araçlar için kullanın.\n\n## Hız Sınırı Başlıkları\n\n`?key=` kimlik doğrulaması kullandığınızda, yanıtlar hız sınırı başlıklarını içerir:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nSınırı aştığınızda:\n\n```\nHTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n \"statusCode\": 429,\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Use Authorization header for unlimited access.\"\n}\n```\n\n## Hız Sınırına Ulaştığınızda\n\n429 alırsanız:\n\n1. **Authorization header'a geçin** (önerilir):\n ```bash\n # Don't: ?key=YOUR_MIND_KEY (60/min limit)\n curl \".../memory/recall?key=YOUR_MIND_KEY\"\n \n # Do: Authorization header (unlimited)\n curl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n ```\n\n2. **Veya `Retry-After` saniye bekleyin** ve yeniden deneyin.\n\n## ?key= Sınırı Neden Var\n\n`?key=` sorgu parametresi yalnızca URL kullanan araçlar (tarayıcılar, `open` komutları) için uygundur, ancak güvenlik ve performans etkileri vardır:\n\n- **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.\n- **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.\n- **Kötüye kullanım önleme:** Sızdırılmış bir `?key=` URL'si paylaşılabilir ve kötüye kullanılabilir. IP sınırı etki alanını sınırlar.\n\n## Önerilen Desenler\n\n### LLM ajanları\n\n```python\n# Always use header auth\nheaders = {\"Authorization\": f\"Bearer {MIND_KEY}\"}\nresponse = requests.get(f\"{URL}/memory/recall\", headers=headers)\n```\n\n### Tarayıcı tabanlı araçlar\n\nAracınız yalnızca URL açabiliyorsa:\n\n```bash\n# OK for occasional use (under 60/min)\nopen \"https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY\"\n\n# For frequent use, switch to a tool that supports headers\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n```\n\n### MCP sunucusu\n\nMCP sunucuları her zaman `SYNAPSE_MIND_KEY` env değişkeni üzerinden header kimlik doğrulaması kullanır — hız sınırı uygulanmaz.\n\n### Toplu içe aktarımlar\n\nToplu işlemler (örn. 1000 bellek içe aktarma) için her zaman header kimlik doğrulaması kullanın. `?key=` üzerinden toplu içe aktarımlar 1 dakika içinde hız sınırına takılır.\n\n## Kotalar (Mind Düzeyi)\n\nŞ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.\n\n## Kullanımınızı İzleme\n\n```bash\n# Check your current rate limit status (with ?key= auth)\ncurl -i \"https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY\" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840\n```\n\n## Sonraki Adımlar\n\n- [Kimlik Doğrulama](/docs/getting-started/authentication)\n- [Hatalar & Hata Yönetimi](/docs/api/errors)\n","content_html":"

Hız Sınırları & Kotalar

\n

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.

\n

Hız Sınırı Politikası

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Kimlik Doğrulama YöntemiSınırKapsam
Mind Key (Authorization: Bearer)YokMind başına
Mind Key (?key=)60 istek/dakikaIP başına
JWT (Authorization: Bearer)YokKullanıcı başına
Herkese açık uç noktalarYokGlobal
\n
Mümkün olduğunda **daima `Authorization: Bearer` başlığını kullanın**. Hız sınırı yoktur. `?key=` seçeneğini yalnızca özel başlık ayarlayamayan araçlar için kullanın.

Hız Sınırı Başlıkları

\n

?key= kimlik doğrulaması kullandığınızda, yanıtlar hız sınırı başlıklarını içerir:

\n
X-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840

Sınırı aştığınızda:

\n
HTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n  "statusCode": 429,\n  "error": "Too Many Requests",\n  "message": "Rate limit exceeded. Use Authorization header for unlimited access."\n}

Hız Sınırına Ulaştığınızda

\n

429 alırsanız:

\n
    \n

  1. Authorization header'a geçin (önerilir):

    \n
    # Don't: ?key=YOUR_MIND_KEY (60/min limit)\ncurl ".../memory/recall?key=YOUR_MIND_KEY"\n\n# Do: Authorization header (unlimited)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall
    2. \n

  2. Veya Retry-After saniye bekleyin ve yeniden deneyin.

    \n
    3. \n
\n

?key= Sınırı Neden Var

\n

?key= sorgu parametresi yalnızca URL kullanan araçlar (tarayıcılar, open komutları) için uygundur, ancak güvenlik ve performans etkileri vardır:

\n\n

Önerilen Desenler

\n

LLM ajanları

\n
# Always use header auth\nheaders = {"Authorization": f"Bearer {MIND_KEY}"}\nresponse = requests.get(f"{URL}/memory/recall", headers=headers)

Tarayıcı tabanlı araçlar

\n

Aracınız yalnızca URL açabiliyorsa:

\n
# OK for occasional use (under 60/min)\nopen "https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY"\n\n# For frequent use, switch to a tool that supports headers\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall

MCP sunucusu

\n

MCP sunucuları her zaman SYNAPSE_MIND_KEY env değişkeni üzerinden header kimlik doğrulaması kullanır — hız sınırı uygulanmaz.

\n

Toplu içe aktarımlar

\n

Toplu işlemler (örn. 1000 bellek içe aktarma) için her zaman header kimlik doğrulaması kullanın. ?key= üzerinden toplu içe aktarımlar 1 dakika içinde hız sınırına takılır.

\n

Kotalar (Mind Düzeyi)

\n

Ş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.

\n

Kullanımınızı İzleme

\n
# Check your current rate limit status (with ?key= auth)\ncurl -i "https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840

Sonraki Adımlar

\n\n","urls":{"html":"/docs/api/rate-limits","text":"/docs/api/rate-limits?format=text","json":"/docs/api/rate-limits?format=json","llm":"/docs/api/rate-limits?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}