HTTP-Statuscodes-Referenz
| Code | Name | Bedeutung |
|---|---|---|
| 100 | Continue | Der Client sollte mit dem Request-Body fortfahren |
| 101 | Switching Protocols | Protokoll-Upgrade akzeptiert (z. B. zu WebSocket) |
| 200 | OK | Die Anfrage war erfolgreich — die Standard-Erfolgsantwort |
| 201 | Erstellt | Eine neue Ressource wurde erstellt (typischer POST-Erfolg) |
| 202 | Akzeptiert | Für asynchrone Verarbeitung eingereiht, noch nicht abgeschlossen |
| 204 | No Content | Erfolg mit absichtlich leerem Body |
| 301 | Moved Permanently | Die Ressource hat eine neue permanente URL — Links aktualisieren; SEO-Wert überträgt sich |
| 302 | Gefunden | Temporäre Weiterleitung (historisch missbraucht; siehe 303/307) |
| 303 | See Other | Weiterleitung zu einem GET unter einer anderen URL (post/redirect/get) |
| 304 | Not Modified | Die zwischengespeicherte Kopie ist noch gültig — per ETag/Last-Modified erneut validieren |
| 307 | Temporary Redirect | Temporäre Weiterleitung, die Methode und Body erhält |
| 308 | Permanent Redirect | Permanente Weiterleitung, die Methode und Body erhält |
| 400 | Bad Request | Der Server kann die Anfrage nicht parsen/verstehen |
| 401 | Unauthorized | Authentifizierung erforderlich oder fehlgeschlagen (trotz des Namens bedeutet es: nicht authentifiziert) |
| 403 | Forbidden | Authentifiziert oder nicht, der Zugriff wird verweigert |
| 404 | Not Found | Keine Ressource unter dieser URL |
| 405 | Method Not Allowed | Die HTTP-Methode wird für diese Ressource nicht unterstützt |
| 406 | Not Acceptable | Keine Darstellung entspricht den Accept-Headern |
| 408 | Request Timeout | Der Client brauchte zu lange, um die Anfrage zu senden |
| 409 | Konflikt | Zustands-Konflikt, z. B. Bearbeitungs-Kollision oder doppelte Erstellung |
| 410 | Gone | Permanent entfernt (stärker als 404 — bewusst verwendet) |
| 411 | Length Required | Content-Length-Header ist erforderlich |
| 413 | Content Too Large | Der Request-Body überschreitet die Server-Grenzen |
| 414 | URI Too Long | Die URL überschreitet die Server-Grenzen |
| 415 | Unsupported Media Type | Der Content-Type der Anfrage wird nicht unterstützt |
| 418 | I'm a Teapot | RFC-2324-Scherzcode, gelegentlich verwendet, um das Kaffeekochen zu verweigern |
| 422 | Unprocessable Content | Die Syntax ist in Ordnung, aber die Semantik schlägt die Validierung fehl (APIs lieben diese) |
| 425 | Too Early | Server nicht bereit, eine möglicherweise wiederholte Anfrage zu verarbeiten |
| 429 | Too Many Requests | Ratenlimit erreicht — zurückfahren, Retry-After respektieren |
| 500 | Internal Server Error | Generischer serverseitiger Fehler |
| 501 | Not Implemented | Der Server unterstützt die Funktionalität nicht |
| 502 | Bad Gateway | Ein Proxy/Gateway erhielt eine ungültige Antwort vom Upstream |
| 503 | Service Unavailable | Überlastet oder wegen Wartung unten — oft vorübergehend, kann Retry-After tragen |
| 504 | Gateway Timeout | Ein Proxy/Gateway wartete zu lange auf den Upstream (Timeout) |
| 505 | HTTP Version Not Supported | Die HTTP-Version in der Anfrage wird nicht unterstützt |
Über uns
Statuscodes sind die Ein-Zahl-Zusammenfassung des Servers für jede Antwort, gruppiert nach Klasse: 1xx informativ, 2xx Erfolg, 3xx Weiterleitung, 4xx der Client irrte, 5xx der Server irrte. Die Tabelle gibt die Codes, denen arbeitende Entwickler tatsächlich begegnen, mit den Nuancen, die in der Praxis zählen — 401 bedeutet trotz seines Namens nicht authentifiziert, 403 ist eine Verweigerung unabhängig vom Login, 422 ist der API-Validierungsfehler, 429 verlangt Backoff. Nicht aufgelistete Codes (der lange Schwanz der 1xx- und experimentellen Codes) sind selten genug, dass die Klasse allein Ihnen sagt, wie Sie mit ihnen umgehen.
Häufig gestellte Fragen
Was ist der Unterschied zwischen 401 und 403?
401: Wir wissen nicht, wer Sie sind (authentifizieren). 403: Wir wissen es, und Sie dürfen trotzdem nicht.
302 oder 307 für eine temporäre Weiterleitung?
307 behält Methode und Body bei; 302 ließ Clients historisch von POST zu GET wechseln. Neue Projekte sollten 307 verwenden (oder 308 für permanent).