Synapse utilise les codes d'état HTTP standard avec un format de réponse d'erreur\ncohérent. Cette page explique comment interpréter et récupérer les erreurs.
\nToutes les erreurs renvoient du JSON avec cette structure :
\n{\n "statusCode": 401,\n "error": "Unauthorized",\n "message": "Mind Key fehlt oder ungültig.",\n "docs": "https://synapse.schaefer.zone/docs/getting-started/authentication"\n}| Champ | \nDescription | \n
|---|---|
statusCode | \nCode d'état HTTP | \n
error | \nNom de l'état HTTP | \n
message | \nDescription de l'erreur lisible par l'humain | \n
docs | \nURL vers la documentation pertinente (le cas échéant) | \n
Succès. La requête a été traitée correctement.
\nSuccès. Une nouvelle ressource a été créée (ex. POST /memory).
Succès. Aucun corps renvoyé (ex. DELETE /memory/:id).
La requête était mal formée. Causes courantes :
\n{\n "statusCode": 400,\n "error": "Bad Request",\n "message": "category must be one of: identity, preference, fact, project, skill, mistake, context, note, credentials"\n}Correction : Vérifiez le corps de la requête par rapport à la documentation de\nl'API. Assurez-vous que tous les champs requis sont présents et ont des valeurs valides.
\nL'authentification a échoué. Causes courantes :
\nAuthorization manquant{\n "statusCode": 401,\n "error": "Unauthorized",\n "message": "Mind Key fehlt oder ungültig.",\n "docs": "https://synapse.schaefer.zone/docs/getting-started/authentication"\n}Correction : Vérifiez votre jeton. Voir Authentification.
\nVous êtes authentifié mais n'êtes pas autorisé à effectuer cette action. Causes\ncourantes :
\nCorrection : Vérifiez si vous utilisez le bon type de jeton pour cet endpoint.
\nLe chemin ou la ressource demandée n'existe pas.
\n{\n "statusCode": 404,\n "error": "Not Found",\n "message": "Route GET /memory/list not found",\n "docs": "https://synapse.schaefer.zone/docs/api/errors"\n}Correction : Appelez GET /endpoints pour voir la liste des endpoints valides.\nComparez votre URL à la liste caractère par caractère.
La requête entre en conflit avec l'état existant. Causes courantes :
\nCorrection : Utilisez une valeur différente, ou utilisez PUT pour mettre à jour\nla ressource existante.
Vous avez atteint une limite de débit. S'applique uniquement à l'authentification par\nparamètre de requête ?key= (60/min).
{\n "statusCode": 429,\n "error": "Too Many Requests",\n "message": "Rate limit exceeded. Use Authorization header for unlimited access."\n}En-têtes de réponse :
\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42Correction : Passez à l'en-tête Authorization: Bearer (sans limite de débit), ou\nattendez Retry-After secondes.
Erreur serveur. Cela ne devrait pas arriver — si c'est le cas, c'est un bug.
\nCorrection :
\nGET /health pour voir si le serveur fonctionneLe serveur est temporairement indisponible (ex. pendant un déploiement, une migration\nde base de données).
\nCorrection : Attendez et réessayez. Vérifiez GET /health.
import time\nimport requests\n\ndef call_with_retry(url, max_retries=3):\n for attempt in range(max_retries):\n try:\n r = requests.get(url, headers={"Authorization": f"Bearer {KEY}"})\n if r.status_code == 429:\n wait = int(r.headers.get("Retry-After", 60))\n time.sleep(wait)\n continue\n if r.status_code >= 500:\n time.sleep(2 ** attempt)\n continue\n return r\n except requests.RequestException:\n time.sleep(2 ** attempt)\n raise Exception(f"Failed after {max_retries} retries")def safe_call(url, key):\n r = requests.get(url, headers={"Authorization": f"Bearer {key}"})\n if r.status_code == 401:\n # Mind Key invalide — avertir l'utilisateur\n raise AuthError("Mind Key invalid or expired")\n return rAuthorization?key= mais la clé est erronéeGET /memory vs POST /memory)GET /endpoints pour les chemins valides?key= et avez dépassé 60 req/minAuthorization: Bearer