Was HTTP-Statuscodes bedeuten

Jedes Mal, wenn dein Browser eine Seite lädt oder eine App eine API aufruft, antwortet der Server mit einem dreistelligen Statuscode. Meist siehst du ihn nie, aber wenn etwas kaputtgeht — ein 404, ein 500 — ist diese Zahl der erste Hinweis. Dieser Ratgeber bringt dir bei, Statuscodes auf einen Blick zu lesen.

Lies die erste Ziffer

Der Trick ist, dass die erste Ziffer dir die Kategorie verrät, sodass du die Absicht eines nie gesehenen Codes verstehen kannst:

• 1xx — Informational: empfangen, wird noch verarbeitet (im Alltag selten).
• 2xx — Success: es hat geklappt.
• 3xx — Redirection: die Ressource ist woanders.
• 4xx — Client error: die Anfrage war falsch (deine Seite).
• 5xx — Server error: die Anfrage war in Ordnung, der Server ist gescheitert.

Diese Trennung 4xx gegen 5xx ist beim Debuggen die nützlichste Unterscheidung: 4xx heißt, korrigiere die Anfrage; 5xx heißt, der Server ist schuld.

Die Codes, denen du wirklich begegnest

Erfolg und Weiterleitungen

• 200 OK — die Standardantwort „es hat geklappt“.
• 201 Created — eine neue Ressource wurde erstellt (nach einem POST).
• 301 Moved Permanently — diese URL ist dauerhaft umgezogen; aktualisiere deine Links. Wichtig für SEO.
• 302 Found — eine vorübergehende Weiterleitung; nutze weiter die ursprüngliche URL.
• 304 Not Modified — deine zwischengespeicherte Kopie ist noch gültig, es wurde also nichts erneut gesendet.

Client-Fehler (4xx)

• 400 Bad Request — die Anfrage war fehlerhaft aufgebaut.
• 401 Unauthorized — du musst dich authentifizieren (anmelden).
• 403 Forbidden — du bist authentifiziert, aber nicht berechtigt.
• 404 Not Found — die Ressource existiert nicht.
• 429 Too Many Requests — du wirst rate-limitiert; mach langsamer.

Server-Fehler (5xx)

• 500 Internal Server Error — ein generischer serverseitiger Fehler.
• 502 Bad Gateway — ein vorgelagerter Server lieferte eine fehlerhafte Antwort.
• 503 Service Unavailable — der Server ist überlastet oder wegen Wartung offline.
• 504 Gateway Timeout — ein vorgelagerter Server antwortete nicht rechtzeitig.

401 vs. 403: eine häufige Verwechslung

Diese beiden fühlen sich ähnlich an, unterscheiden sich aber in einem Wort. 401 Unauthorized bedeutet eigentlich „unauthentifiziert“ — der Server weiß nicht, wer du bist, also melde dich an. 403 Forbidden heißt, der Server weiß, wer du bist, und du bist trotzdem nicht erlaubt. Das eine dreht sich um Identität, das andere um Berechtigung.

Die vollständige Liste

Für jeden registrierten Code mit seiner Bedeutung — durchsuchbar und nach Klasse gruppiert — siehe unsere vollständige HTTP-Statuscode-Referenz. Wenn du API-Antworten debuggst, behandeln unsere Ratgeber zu JWTs und URL-Kodierung zwei weitere Dinge, denen du ständig begegnest.