{"title":"Лимиты запросов и квоты","slug":"rate-limits","category":"api","summary":"Политика лимитов запросов для Synapse API — заголовок Bearer (без лимита), ?key= (60/мин), публичные эндпоинты.","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":309,"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":"ru","translated":true,"requested_lang":"ru","content_markdown":"\n# Лимиты запросов и квоты\n\nВ Synapse применяется простая и предсказуемая политика лимитов запросов,\nкоторая предотвращает злоупотребления, не мешая легитимному использованию.\n\n## Политика лимитов запросов\n\n| Способ аутентификации | Лимит | Область |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **Нет** | На mind |\n| Mind Key (`?key=`) | 60 запросов/мин | На IP |\n| JWT (`Authorization: Bearer`) | **Нет** | На пользователя |\n| Публичные эндпоинты | **Нет** | Глобально |\n\n> [!TIP]\n> **Всегда используйте заголовок `Authorization: Bearer`**, когда это возможно.\n> Он не имеет лимита. Используйте `?key=` только для инструментов, которые не\n> могут устанавливать пользовательские заголовки.\n\n## Заголовки лимитов запросов\n\nПри использовании аутентификации `?key=` ответы содержат заголовки лимита:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nПри превышении лимита:\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\nПри получении 429:\n\n1. **Перейдите на заголовок Authorization** (рекомендуется):\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. **Или подождите `Retry-After` секунд** и повторите запрос.\n\n## Почему для `?key=` существует лимит\n\nQuery-параметр `?key=` удобен для инструментов, работающих только с URL (браузеры,\nкоманда `open`), но имеет последствия для безопасности и производительности:\n\n- **Безопасность:** Query-параметры попадают в журналы доступа сервера, историю\n браузера и заголовки Referer. Ограничение использования снижает риски.\n- **Производительность:** Аутентификация через query-параметр требует лимитера\n по IP (Redis-запрос на каждый запрос), что добавляет задержку. Header-auth\n обходит это.\n- **Предотвращение злоупотреблений:** Утёкший URL с `?key=` могут расшарить и\n закидать запросами. Лимит по IP ограничивает масштаб ущерба.\n\n## Рекомендуемые паттерны\n\n### LLM-агенты\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### Браузерные инструменты\n\nЕсли ваш инструмент может только открывать URL:\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-сервер\n\nMCP-серверы всегда используют header-auth через переменную окружения\n`SYNAPSE_MIND_KEY` — лимит не применяется.\n\n### Массовый импорт\n\nДля массовых операций (например, импорт 1000 воспоминаний) всегда используйте\nheader-auth. Массовый импорт через `?key=` упрётся в лимит менее чем за минуту.\n\n## Квоты (на уровне mind)\n\nВ настоящее время квоты на размер хранилища или количество воспоминаний на mind\nотсутствуют. Все лимиты применяются на уровне аутентификации/IP, а не данных.\nЭто может измениться в будущем для обеспечения справедливости в multi-tenant-среде.\n\n## Мониторинг использования\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\n- [Аутентификация](/docs/getting-started/authentication)\n- [Ошибки и обработка ошибок](/docs/api/errors)\n","content_html":"

Лимиты запросов и квоты

\n

В Synapse применяется простая и предсказуемая политика лимитов запросов,\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\n\n
Способ аутентификацииЛимитОбласть
Mind Key (Authorization: Bearer)НетНа mind
Mind Key (?key=)60 запросов/минНа IP
JWT (Authorization: Bearer)НетНа пользователя
Публичные эндпоинтыНетГлобально
\n
**Всегда используйте заголовок `Authorization: Bearer`**, когда это возможно.\nОн не имеет лимита. Используйте `?key=` только для инструментов, которые не\nмогут устанавливать пользовательские заголовки.

Заголовки лимитов запросов

\n

При использовании аутентификации ?key= ответы содержат заголовки лимита:

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

При превышении лимита:

\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

При получении 429:

\n
    \n

  1. Перейдите на заголовок Authorization (рекомендуется):

    \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. Или подождите Retry-After секунд и повторите запрос.

    \n
    3. \n
\n

Почему для ?key= существует лимит

\n

Query-параметр ?key= удобен для инструментов, работающих только с URL (браузеры,\nкоманда open), но имеет последствия для безопасности и производительности:

\n\n

Рекомендуемые паттерны

\n

LLM-агенты

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

Браузерные инструменты

\n

Если ваш инструмент может только открывать URL:

\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-сервер

\n

MCP-серверы всегда используют header-auth через переменную окружения\nSYNAPSE_MIND_KEY — лимит не применяется.

\n

Массовый импорт

\n

Для массовых операций (например, импорт 1000 воспоминаний) всегда используйте\nheader-auth. Массовый импорт через ?key= упрётся в лимит менее чем за минуту.

\n

Квоты (на уровне mind)

\n

В настоящее время квоты на размер хранилища или количество воспоминаний на mind\nотсутствуют. Все лимиты применяются на уровне аутентификации/IP, а не данных.\nЭто может измениться в будущем для обеспечения справедливости в multi-tenant-среде.

\n

Мониторинг использования

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