# Fouten & Foutafhandeling
SUMMARY: HTTP-statuscodes, foutresponsformaat en hoe u veelvoorkomende fouten kunt herstellen.

KEY CONTEXT:
Error format: { statusCode, error, message, docs? }
Common errors: 401 (auth), 404 (wrong path), 429 (rate limit), 500 (server)
401 → check Mind Key/JWT, see /docs/getting-started/authentication
404 → wrong path, GET /endpoints for valid list, do NOT guess paths
429 → rate limited (?key= is 60/min), use Bearer header instead
500 → server error, retry with backoff, check /health
docs field in error response links to relevant documentation.

Fouten & Foutafhandeling
Synapse gebruikt standaard HTTP-statuscodes met een consistent foutresponsformaat.
Deze pagina legt uit hoe u fouten kunt interpreteren en ervan kunt herstellen.
Formaat van foutrespons
Alle fouten retourneren JSON met deze structuur:
[CODE BLOCK]
| Veld | Beschrijving |
|------|--------------|
|  | HTTP-statuscode |
|  | HTTP-statusnaam |
|  | Door mensen leesbare foutbeschrijving |
|  | URL naar relevante documentatie (indien van toepassing) |
HTTP-statuscodes
200 OK
Succes. Het verzoek is correct verwerkt.
201 Created
Succes. Een nieuwe resource is aangemaakt (bijv. ).
204 No Content
Succes. Geen body geretourneerd (bijv. ).
400 Bad Request
Het verzoek was ongeldig. Veelvoorkomende oorzaken:
- Ontbrekende verplichte JSON-velden
- Ongeldige JSON-syntaxis
- Ongeldige enum-waarde (bijv. verkeerde categorie)
[CODE BLOCK]
Oplossing: Controleer de requestbody tegen de API-documentatie. Zorg dat alle
verplichte velden aanwezig zijn en geldige waarden hebben.
401 Unauthorized
Authenticatie mislukt. Veelvoorkomende oorzaken:
- Ontbrekende -header
- Ongeldige Mind Key of JWT
- Een Mind Key gebruiken waar een JWT vereist is (of omgekeerd)
[CODE BLOCK]
Oplossing: Verifieer uw token. Zie Authenticatie.
403 Forbidden
U bent geauthenticeerd maar mag deze actie niet uitvoeren. Veelvoorkomende oorzaken:
- Poging om een mind van een andere gebruiker te verwijderen
- Poging om een memory te verifiëren met een Mind Key (vereist JWT)
- Mind is uitgeschakeld
Oplossing: Controleer of u het juiste tokentype gebruikt voor dit eindpunt.
404 Not Found
Het aangevraagde pad of de resource bestaat niet.
> [!CRITICAL]
> Raad GEEN eindpuntpaden. Alleen de paden vermeld in 
> bestaan. Als u een 404 krijgt, heeft u een verkeerd pad gebruikt.
[CODE BLOCK]
Oplossing: Roep  aan om de lijst met geldige eindpunten te zien.
Vergelijk uw URL teken voor teken met de lijst.
409 Conflict
Het verzoek conflicteert met de bestaande staat. Veelvoorkomende oorzaken:
- Poging om te registreren met een e-mailadres dat al bestaat
- Dubbele webhook-URL
Oplossing: Gebruik een andere waarde, of gebruik  om de bestaande resource bij te werken.
429 Too Many Requests
U heeft een ratelimit bereikt. Geldt alleen voor -queryparameter-authenticatie (60/min).
[CODE BLOCK]
Responsheaders:
[CODE BLOCK]
Oplossing: Schakel over naar -header (geen ratelimit), of wacht
 seconden.
500 Internal Server Error
Serverfout. Dit zou niet moeten gebeuren — als het toch voorkomt, is het een bug.
Oplossing:
1. Probeer opnieuw met exponentiële backoff (1s, 2s, 4s, 8s)
2. Controleer  om te zien of de server draait
3. Als het aanhoudt, meld de fout
503 Service Unavailable
De server is tijdelijk niet beschikbaar (bijv. tijdens deployment, databasemigratie).
Oplossing: Wacht en probeer opnieuw. Controleer .
Herstelpatronen
Opnieuw proberen met exponentiële backoff
[CODE BLOCK]
Auth-foutafhandeling
[CODE BLOCK]
Veelvoorkomende foutscenario's
"Mind Key fehlt oder ungültig"
- U bent de -header vergeten
- U heeft  gebruikt maar de sleutel is onjuist
- U gebruikt een JWT waar een Mind Key vereist is
"Route not found"
- U heeft een pad geraden dat niet bestaat
- U heeft een werkwoord verkeerd gebruikt (bijv.  vs )
- Controleer  voor geldige paden
"Rate limit exceeded"
- U gebruikt  en heeft 60 aanvragen/min overschreden
- Schakel over naar -header
Volgende stappen
- Authenticatie
- API-overzicht
- Ratelimits