# Fel & felhantering
SUMMARY: HTTP-statuskoder, format för felsvar och hur man återhämtar sig från vanliga fel.

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.

Fel & felhantering
Synapse använder standardiserade HTTP-statuskoder med ett konsekvent felsvarsformat.
Den här sidan förklarar hur man tolkar och återhämtar sig från fel.
Format för felsvar
Alla fel returnerar JSON med denna struktur:
[CODE BLOCK]
| Fält | Beskrivning |
|-------|-------------|
|  | HTTP-statuskod |
|  | HTTP-statusnamn |
|  | Läsbar felbeskrivning för människor |
|  | URL till relevant dokumentation (när tillämpligt) |
HTTP-statuskoder
200 OK
Lyckades. Begäran behandlades korrekt.
201 Created
Lyckades. En ny resurs skapades (t.ex. ).
204 No Content
Lyckades. Ingen body returnerades (t.ex. ).
400 Bad Request
Begäran var felaktig. Vanliga orsaker:
- Saknade obligatoriska JSON-fält
- Ogiltig JSON-syntax
- Ogiltigt enum-värde (t.ex. fel kategori)
[CODE BLOCK]
Lösning: Kontrollera begärans body mot API-dokumentationen. Se till att alla
obligatoriska fält finns med och har giltiga värden.
401 Unauthorized
Autentiseringen misslyckades. Vanliga orsaker:
- Saknad -header
- Ogiltig Mind Key eller JWT
- Användning av en Mind Key där JWT krävs (eller tvärtom)
[CODE BLOCK]
Lösning: Verifiera din token. Se Autentisering.
403 Forbidden
Ni är autentiserade men får inte utföra denna åtgärd. Vanliga orsaker:
- Försöker ta bort en annan användares mind
- Försöker verifiera ett minne med en Mind Key (kräver JWT)
- Mind är inaktiverad
Lösning: Kontrollera om ni använder rätt tokentyp för denna endpoint.
404 Not Found
Den begärda sökvägen eller resursen finns inte.
> [!CRITICAL]
> Gissa INTE endpointsökvägar. Endast de sökvägar som listas i
>  existerar. Om ni får 404 använde ni en felaktig sökväg.
[CODE BLOCK]
Lösning: Anropa  för att se listan över giltiga endpoints.
Jämför er URL mot listan tecken för tecken.
409 Conflict
Begäran är i konflikt med befintligt tillstånd. Vanliga orsaker:
- Försöker registrera med en e-postadress som redan finns
- Duplicerad webhook-URL
Lösning: Använd ett annat värde, eller använd  för att uppdatera
befintlig resurs.
429 Too Many Requests
Ni nådde en hastighetsgräns. Gäller endast -queryparameter-autentisering
(60/min).
[CODE BLOCK]
Svarshuvuden:
[CODE BLOCK]
Lösning: Byt till -header (ingen hastighetsgräns),
eller vänta  sekunder.
500 Internal Server Error
Serverfel. Detta bör inte inträffa — om det gör det är det en bugg.
Lösning:
1. Försök igen med exponentiell backoff (1 s, 2 s, 4 s, 8 s)
2. Kontrollera  för att se om servern är uppe
3. Rapportera felet om det kvarstår
503 Service Unavailable
Servern är tillfälligt nere (t.ex. under driftsättning, databasmigrering).
Lösning: Vänta och försök igen. Kontrollera .
Återställningsmönster
Försök igen med exponentiell backoff
[CODE BLOCK]
Hantering av autentiseringsfel
[CODE BLOCK]
Vanliga felscenarier
"Mind Key fehlt oder ungültig"
- Ni glömde -headern
- Ni använde  men nyckeln är fel
- Ni använder en JWT där en Mind Key krävs
"Route not found"
- Ni gissade en sökväg som inte finns
- Ni använde ett verb fel (t.ex.  vs )
- Kontrollera  för giltiga sökvägar
"Rate limit exceeded"
- Ni använder  och överskred 60 req/min
- Byt till -header
Nästa steg
- Autentisering
- API-översikt
- Hastighetsgränser