{"title":"Limity żądań i przydziały","slug":"rate-limits","category":"api","summary":"Polityka limitów żądań dla API Synapse — nagłówek Bearer (bez limitu), ?key= (60/min), endpointy publiczne.","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":336,"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":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Limity żądań i przydziały\n\nSynapse posiada prostą i przewidywalną politykę limitów żądań, zaprojektowaną w\ncelu zapobiegania nadużyciom, nie blokując jednocześnie prawidłowego użytku.\n\n## Polityka limitów żądań\n\n| Metoda autoryzacji | Limit | Zakres |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **Brak** | Na umysł |\n| Mind Key (`?key=`) | 60 żądań/min | Na IP |\n| JWT (`Authorization: Bearer`) | **Brak** | Na użytkownika |\n| Endpointy publiczne | **Brak** | Globalny |\n\n> [!TIP]\n> **Należy zawsze używać nagłówka `Authorization: Bearer`, gdy to możliwe.** Nie\n> ma on limitu żądań. `?key=` należy stosować tylko w narzędziach, które nie\n> potrafią ustawiać własnych nagłówków.\n\n## Nagłówki limitu żądań\n\nGdy używana jest autoryzacja `?key=`, odpowiedzi zawierają nagłówki limitu:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nPo przekroczeniu limitu:\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## Po osiągnięciu limitu żądań\n\nW przypadku otrzymania 429:\n\n1. **Przełączyć się na nagłówek Authorization** (zalecane):\n ```bash\n # Nie: ?key=YOUR_MIND_KEY (limit 60/min)\n curl \".../memory/recall?key=YOUR_MIND_KEY\"\n \n # Tak: nagłówek Authorization (bez limitu)\n curl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n ```\n\n2. **Lub odczekać `Retry-After` sekund** i ponowić żądanie.\n\n## Dlaczego istnieje limit dla `?key=`\n\nParametr zapytania `?key=` jest wygodny dla narzędzi opartych wyłącznie na URL\n(przeglądarki, polecenia `open`), ale niesie ze sobą implikacje bezpieczeństwa i\nwydajności:\n\n- **Bezpieczeństwo:** Parametry zapytania są rejestrowane w logach dostępu\n serwera, historii przeglądarki i nagłówkach Referer. Ograniczenie użycia\n zmniejsza ekspozycję.\n- **Wydajność:** Autoryzacja parametrem zapytania wymaga ogranicznika opartego na\n IP (odpytanie Redis przy każdym żądaniu), co dodaje opóźnienie. Autoryzacja\n nagłówkiem pomija ten krok.\n- **Zapobieganie nadużyciom:** Wyciekły URL `?key=` mógłby zostać udostępniony i\n masowo wywoływany. Limit IP ogranicza obszar rażenia.\n\n## Zalecane wzorce\n\n### Agenci LLM\n\n```python\n# Zawsze używać autoryzacji nagłówkiem\nheaders = {\"Authorization\": f\"Bearer {MIND_KEY}\"}\nresponse = requests.get(f\"{URL}/memory/recall\", headers=headers)\n```\n\n### Narzędzia oparte na przeglądarce\n\nJeśli narzędzie potrafi tylko otwierać URL-e:\n\n```bash\n# Dopuszczalne do okazjonalnego użycia (poniżej 60/min)\nopen \"https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY\"\n\n# Do częstego użycia przełączyć się na narzędzie obsługujące nagłówki\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n```\n\n### Serwer MCP\n\nSerwery MCP zawsze korzystają z autoryzacji nagłówkiem przez zmienną środowiskową\n`SYNAPSE_MIND_KEY` — limit nie ma zastosowania.\n\n### Importy masowe\n\nW przypadku operacji masowych (np. import 1000 wspomnień) zawsze należy używać\nautoryzacji nagłówkiem. Importy przez `?key=` osiągną limit w ciągu minuty.\n\n## Przydziały (poziom umysłu)\n\nObecnie nie ma przydziałów na poziomie umysłu dotyczących rozmiaru pamięci lub\nliczby wspomnień. Wszystkie limity znajdują się na poziomie autoryzacji/IP, a nie\ndanych. Może się to zmienić w przyszłości w celu sprawiedliwego współdzielenia\nw środowisku wielodostępnym.\n\n## Monitorowanie użycia\n\n```bash\n# Sprawdzenie aktualnego statusu limitu (z autoryzacją ?key=)\ncurl -i \"https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY\" | grep -i ratelimit\n\n# Wynik:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840\n```\n\n## Następne kroki\n\n- [Autoryzacja](/docs/getting-started/authentication)\n- [Błędy i ich obsługa](/docs/api/errors)\n","content_html":"

Limity żądań i przydziały

\n

Synapse posiada prostą i przewidywalną politykę limitów żądań, zaprojektowaną w\ncelu zapobiegania nadużyciom, nie blokując jednocześnie prawidłowego użytku.

\n

Polityka limitów żądań

\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
Metoda autoryzacjiLimitZakres
Mind Key (Authorization: Bearer)BrakNa umysł
Mind Key (?key=)60 żądań/minNa IP
JWT (Authorization: Bearer)BrakNa użytkownika
Endpointy publiczneBrakGlobalny
\n
**Należy zawsze używać nagłówka `Authorization: Bearer`, gdy to możliwe.** Nie\nma on limitu żądań. `?key=` należy stosować tylko w narzędziach, które nie\npotrafią ustawiać własnych nagłówków.

Nagłówki limitu żądań

\n

Gdy używana jest autoryzacja ?key=, odpowiedzi zawierają nagłówki limitu:

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

Po przekroczeniu limitu:

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

Po osiągnięciu limitu żądań

\n

W przypadku otrzymania 429:

\n
    \n

  1. Przełączyć się na nagłówek Authorization (zalecane):

    \n
    # Nie: ?key=YOUR_MIND_KEY (limit 60/min)\ncurl ".../memory/recall?key=YOUR_MIND_KEY"\n\n# Tak: nagłówek Authorization (bez limitu)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall
    2. \n

  2. Lub odczekać Retry-After sekund i ponowić żądanie.

    \n
    3. \n
\n

Dlaczego istnieje limit dla ?key=

\n

Parametr zapytania ?key= jest wygodny dla narzędzi opartych wyłącznie na URL\n(przeglądarki, polecenia open), ale niesie ze sobą implikacje bezpieczeństwa i\nwydajności:

\n\n

Zalecane wzorce

\n

Agenci LLM

\n
# Zawsze używać autoryzacji nagłówkiem\nheaders = {"Authorization": f"Bearer {MIND_KEY}"}\nresponse = requests.get(f"{URL}/memory/recall", headers=headers)

Narzędzia oparte na przeglądarce

\n

Jeśli narzędzie potrafi tylko otwierać URL-e:

\n
# Dopuszczalne do okazjonalnego użycia (poniżej 60/min)\nopen "https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY"\n\n# Do częstego użycia przełączyć się na narzędzie obsługujące nagłówki\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall

Serwer MCP

\n

Serwery MCP zawsze korzystają z autoryzacji nagłówkiem przez zmienną środowiskową\nSYNAPSE_MIND_KEY — limit nie ma zastosowania.

\n

Importy masowe

\n

W przypadku operacji masowych (np. import 1000 wspomnień) zawsze należy używać\nautoryzacji nagłówkiem. Importy przez ?key= osiągną limit w ciągu minuty.

\n

Przydziały (poziom umysłu)

\n

Obecnie nie ma przydziałów na poziomie umysłu dotyczących rozmiaru pamięci lub\nliczby wspomnień. Wszystkie limity znajdują się na poziomie autoryzacji/IP, a nie\ndanych. Może się to zmienić w przyszłości w celu sprawiedliwego współdzielenia\nw środowisku wielodostępnym.

\n

Monitorowanie użycia

\n
# Sprawdzenie aktualnego statusu limitu (z autoryzacją ?key=)\ncurl -i "https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY" | grep -i ratelimit\n\n# Wynik:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840

Następne kroki

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