{"title":"Limites de débit & quotas","slug":"rate-limits","category":"api","summary":"Politique de limites de débit pour l'API Synapse — en-tête Bearer (illimité), ?key= (60/min), endpoints publics.","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":405,"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":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Limites de débit & quotas\n\nSynapse a une politique de limites de débit simple et prévisible, conçue pour\nprévenir les abus sans gêner les usages légitimes.\n\n## Politique de limites de débit\n\n| Méthode d'auth | Limite | Portée |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **Aucune** | Par mind |\n| Mind Key (`?key=`) | 60 req/min | Par IP |\n| JWT (`Authorization: Bearer`) | **Aucune** | Par utilisateur |\n| Endpoints publics | **Aucune** | Globale |\n\n> [!TIP]\n> **Utilisez toujours l'en-tête `Authorization: Bearer`** lorsque c'est possible. Il\n> n'a aucune limite de débit. N'utilisez `?key=` que pour les outils qui ne peuvent\n> pas définir d'en-têtes personnalisés.\n\n## En-têtes de limite de débit\n\nLorsque vous utilisez l'authentification `?key=`, les réponses incluent des en-têtes\nde limite de débit :\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nLorsque vous dépassez la limite :\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## Que faire en cas de limite de débit\n\nSi vous obtenez un 429 :\n\n1. **Passez à l'en-tête Authorization** (recommandé) :\n ```bash\n # À éviter : ?key=YOUR_MIND_KEY (limite 60/min)\n curl \".../memory/recall?key=YOUR_MIND_KEY\"\n \n # À faire : en-tête Authorization (illimité)\n curl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n ```\n\n2. **Ou attendez `Retry-After` secondes** et réessayez.\n\n## Pourquoi la limite ?key= existe\n\nLe paramètre de requête `?key=` est pratique pour les outils n'utilisant que des URLs\n(navigateurs, commandes `open`), mais il a des implications de sécurité et de\nperformance :\n\n- **Sécurité :** Les paramètres de requête sont consignés dans les journaux d'accès\n serveur, l'historique du navigateur et les en-têtes Referer. Limiter l'usage réduit\n l'exposition.\n- **Performance :** L'authentification par paramètre de requête nécessite un\n limiteur de débit basé sur l'IP (recherche Redis par requête), ce qui ajoute de la\n latence. L'authentification par en-tête l'évite.\n- **Prévention des abus :** Une URL `?key=` fuite pourrait être partagée et martelée.\n La limite par IP contient le rayon d'impact.\n\n## Schémas recommandés\n\n### Agents LLM\n\n```python\n# Toujours utiliser l'authentification par en-tête\nheaders = {\"Authorization\": f\"Bearer {MIND_KEY}\"}\nresponse = requests.get(f\"{URL}/memory/recall\", headers=headers)\n```\n\n### Outils basés sur navigateur\n\nSi votre outil ne peut qu'ouvrir des URLs :\n\n```bash\n# OK pour un usage occasionnel (sous 60/min)\nopen \"https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY\"\n\n# Pour un usage fréquent, passez à un outil qui prend en charge les en-têtes\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n```\n\n### Serveur MCP\n\nLes serveurs MCP utilisent toujours l'authentification par en-tête via la variable\nd'environnement `SYNAPSE_MIND_KEY` — aucune limite de débit ne s'applique.\n\n### Imports en masse\n\nPour les opérations en masse (ex. import de 1000 mémoires), utilisez toujours\nl'authentification par en-tête. Les imports en masse via `?key=` atteindront la\nlimite de débit en moins d'une minute.\n\n## Quotas (niveau mind)\n\nIl n'y a actuellement aucun quota par mind sur la taille de stockage ou le nombre de\nmémoires. Toutes les limites se situent au niveau auth/IP, pas au niveau des données.\nCela pourrait changer à l'avenir pour l'équité multi-tenant.\n\n## Surveiller votre utilisation\n\n```bash\n# Vérifiez votre statut actuel de limite de débit (avec auth ?key=)\ncurl -i \"https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY\" | grep -i ratelimit\n\n# Sortie :\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840\n```\n\n## Prochaines étapes\n\n- [Authentification](/docs/getting-started/authentication)\n- [Erreurs & gestion des erreurs](/docs/api/errors)\n","content_html":"

Limites de débit & quotas

\n

Synapse a une politique de limites de débit simple et prévisible, conçue pour\nprévenir les abus sans gêner les usages légitimes.

\n

Politique de limites de débit

\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
Méthode d'authLimitePortée
Mind Key (Authorization: Bearer)AucunePar mind
Mind Key (?key=)60 req/minPar IP
JWT (Authorization: Bearer)AucunePar utilisateur
Endpoints publicsAucuneGlobale
\n
**Utilisez toujours l'en-tête `Authorization: Bearer`** lorsque c'est possible. Il\nn'a aucune limite de débit. N'utilisez `?key=` que pour les outils qui ne peuvent\npas définir d'en-têtes personnalisés.

En-têtes de limite de débit

\n

Lorsque vous utilisez l'authentification ?key=, les réponses incluent des en-têtes\nde limite de débit :

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

Lorsque vous dépassez la limite :

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

Que faire en cas de limite de débit

\n

Si vous obtenez un 429 :

\n
    \n

  1. Passez à l'en-tête Authorization (recommandé) :

    \n
    # À éviter : ?key=YOUR_MIND_KEY (limite 60/min)\ncurl ".../memory/recall?key=YOUR_MIND_KEY"\n\n# À faire : en-tête Authorization (illimité)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall
    2. \n

  2. Ou attendez Retry-After secondes et réessayez.

    \n
    3. \n
\n

Pourquoi la limite ?key= existe

\n

Le paramètre de requête ?key= est pratique pour les outils n'utilisant que des URLs\n(navigateurs, commandes open), mais il a des implications de sécurité et de\nperformance :

\n\n

Schémas recommandés

\n

Agents LLM

\n
# Toujours utiliser l'authentification par en-tête\nheaders = {"Authorization": f"Bearer {MIND_KEY}"}\nresponse = requests.get(f"{URL}/memory/recall", headers=headers)

Outils basés sur navigateur

\n

Si votre outil ne peut qu'ouvrir des URLs :

\n
# OK pour un usage occasionnel (sous 60/min)\nopen "https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY"\n\n# Pour un usage fréquent, passez à un outil qui prend en charge les en-têtes\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall

Serveur MCP

\n

Les serveurs MCP utilisent toujours l'authentification par en-tête via la variable\nd'environnement SYNAPSE_MIND_KEY — aucune limite de débit ne s'applique.

\n

Imports en masse

\n

Pour les opérations en masse (ex. import de 1000 mémoires), utilisez toujours\nl'authentification par en-tête. Les imports en masse via ?key= atteindront la\nlimite de débit en moins d'une minute.

\n

Quotas (niveau mind)

\n

Il n'y a actuellement aucun quota par mind sur la taille de stockage ou le nombre de\nmémoires. Toutes les limites se situent au niveau auth/IP, pas au niveau des données.\nCela pourrait changer à l'avenir pour l'équité multi-tenant.

\n

Surveiller votre utilisation

\n
# Vérifiez votre statut actuel de limite de débit (avec auth ?key=)\ncurl -i "https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY" | grep -i ratelimit\n\n# Sortie :\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840

Prochaines étapes

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