{"title":"Hastighetsgränser & kvoter","slug":"rate-limits","category":"api","summary":"Principer för hastighetsgränser i Synapse API — Bearer-header (obegränsat), ?key= (60/min), publika endpoints.","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":293,"read_minutes":1,"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":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Hastighetsgränser & kvoter\n\nSynapse har en enkel, förutsägbar princip för hastighetsgränser som utformats\nför att förhindra missbruk utan att vara i vägen för legitim användning.\n\n## Princip för hastighetsgränser\n\n| Autentiseringsmetod | Gräns | Omfattning |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **Ingen** | Per-mind |\n| Mind Key (`?key=`) | 60 req/min | Per-IP |\n| JWT (`Authorization: Bearer`) | **Ingen** | Per-användare |\n| Publika endpoints | **Ingen** | Global |\n\n> [!TIP]\n> **Använd alltid `Authorization: Bearer`-headern** när det är möjligt. Den har\n> ingen hastighetsgräns. Använd `?key=` endast för verktyg som inte kan sätta\n> egna headers.\n\n## Headers för hastighetsgränser\n\nNär ni använder `?key=`-autentisering inkluderar svar headers för hastighetsgräns:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nNär ni överskrider gränsen:\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## När ni når en hastighetsgräns\n\nOm ni får en 429:\n\n1. **Byt till Authorization-header** (rekommenderas):\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. **Eller vänta `Retry-After` sekunder** och försök igen.\n\n## Varför ?key=-gränsen finns\n\nQueryparametern `?key=` är bekväm för URL-endast-verktyg (webbläsare,\n`open`-kommandon), men har säkerhets- och prestandakonsekvenser:\n\n- **Säkerhet:** Queryparametrar loggas i serverns åtkomstloggar,\n webbläsarhistorik och Referer-headers. Begränsad användning minskar exponeringen.\n- **Prestanda:** Queryparameter-autentisering kräver en IP-baserad\n hastighetsbegränsare (Redis-uppslag per begäran), vilket lägger till latens.\n Header-autentisering hoppar över detta.\n- **Missbruksförebyggande:** En läckt `?key=`-URL skulle kunna delas och\n överbelastas. IP-gränsen begränsar skadeomfånget.\n\n## Rekommenderade mönster\n\n### LLM-agenter\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### Webbläsarbaserade verktyg\n\nOm ert verktyg bara kan öppna URL:er:\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-server\n\nMCP-servrar använder alltid header-autentisering via miljövariabeln\n`SYNAPSE_MIND_KEY` — ingen hastighetsgräns gäller.\n\n### Massimport\n\nFör massåtgärder (t.ex. import av 1000 minnen), använd alltid header-autentisering.\nMassimport via `?key=` når hastighetsgränsen inom 1 minut.\n\n## Kvoter (Mind-nivå)\n\nDet finns för närvarande inga kvoter per mind för lagringsstorlek eller antal\nminnen. Alla gränser är på auth/IP-nivå, inte datanivå. Detta kan ändras i\nframtiden för rättvisa i miljöer med flera användare.\n\n## Övervaka er användning\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## Nästa steg\n\n- [Autentisering](/docs/getting-started/authentication)\n- [Fel & felhantering](/docs/api/errors)\n","content_html":"

Hastighetsgränser & kvoter

\n

Synapse har en enkel, förutsägbar princip för hastighetsgränser som utformats\nför att förhindra missbruk utan att vara i vägen för legitim användning.

\n

Princip för hastighetsgränser

\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
AutentiseringsmetodGränsOmfattning
Mind Key (Authorization: Bearer)IngenPer-mind
Mind Key (?key=)60 req/minPer-IP
JWT (Authorization: Bearer)IngenPer-användare
Publika endpointsIngenGlobal
\n
**Använd alltid `Authorization: Bearer`-headern** när det är möjligt. Den har\ningen hastighetsgräns. Använd `?key=` endast för verktyg som inte kan sätta\negna headers.

Headers för hastighetsgränser

\n

När ni använder ?key=-autentisering inkluderar svar headers för hastighetsgräns:

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

När ni överskrider gränsen:

\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}

När ni når en hastighetsgräns

\n

Om ni får en 429:

\n
    \n

  1. Byt till Authorization-header (rekommenderas):

    \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. Eller vänta Retry-After sekunder och försök igen.

    \n
    3. \n
\n

Varför ?key=-gränsen finns

\n

Queryparametern ?key= är bekväm för URL-endast-verktyg (webbläsare,\nopen-kommandon), men har säkerhets- och prestandakonsekvenser:

\n\n

Rekommenderade mönster

\n

LLM-agenter

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

Webbläsarbaserade verktyg

\n

Om ert verktyg bara kan öppna URL:er:

\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-server

\n

MCP-servrar använder alltid header-autentisering via miljövariabeln\nSYNAPSE_MIND_KEY — ingen hastighetsgräns gäller.

\n

Massimport

\n

För massåtgärder (t.ex. import av 1000 minnen), använd alltid header-autentisering.\nMassimport via ?key= når hastighetsgränsen inom 1 minut.

\n

Kvoter (Mind-nivå)

\n

Det finns för närvarande inga kvoter per mind för lagringsstorlek eller antal\nminnen. Alla gränser är på auth/IP-nivå, inte datanivå. Detta kan ändras i\nframtiden för rättvisa i miljöer med flera användare.

\n

Övervaka er användning

\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ästa steg

\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"]}