Skip to content

HTTP-Statuscodes erklärt

Jeder gängige HTTP-Antwortstatuscode, nach Klasse gruppiert: was er bedeutet und wann er auftritt. Die Schnellreferenz zum Tool HTTP-Statuscodes.

HTTP-Statuscodes folgen einem Muster: Die erste Ziffer benennt die Klasse, der Rest ist Detail. 1xx bedeutet Information, 2xx Erfolg, 3xx Umleitung, 4xx einen Fehler des Clients, 5xx einen Fehler des Servers. Erst die erste Ziffer lesen. Das Begleit-Tool schlägt einen einzelnen Code im Detail nach.

Nachschlagetabelle · 55 EinträgeTool http-status-codes öffnen →
55 of 55 rows
1xx Informationell
ContinueDer Server hat die Request-Header empfangen; der Client darf den Body senden.Nach einer Preflight-Prüfung vor dem Upload eines großen Bodys.
Switching ProtocolsDer Server stimmt dem Wechsel zum vom Client angeforderten Protokoll zu.Upgrade einer HTTP-Verbindung auf WebSocket.
ProcessingDer Server hat die Anfrage erhalten und arbeitet noch daran.Ein WebDAV-Server bestätigt eine lange Anfrage, damit beim Client kein Timeout auftritt.
Early HintsDer Server sendet vorläufige Header, bevor die finale Antwort bereit ist.Ein Browser darf Assets vorladen, während die Seite noch gerendert wird.
2xx Erfolg
OKDie Anfrage war erfolgreich; der Antwort-Body enthält das Ergebnis.Standard-Erfolg für GET oder PUT.
CreatedDie Anfrage war erfolgreich und eine neue Ressource wurde erstellt.Antwort nach einem erfolgreichen POST, der etwas anlegt.
AcceptedDie Anfrage wurde zur Verarbeitung angenommen, ist aber noch nicht fertig.Ein lang laufender Job wurde gestartet und läuft asynchron.
Non-Authoritative InformationDie Anfrage war erfolgreich, aber die zurückgegebenen Daten wurden auf dem Rückweg verändert.Ein Proxy oder Cache liefert veränderte Metadaten statt denen des Ursprungs.
No ContentDie Anfrage war erfolgreich; es gibt keinen Body zurückzugeben.Ein DELETE war erfolgreich, oder ein PUT ohne etwas mitzuteilen.
Reset ContentDie Anfrage war erfolgreich; der Client soll die Ansicht zurücksetzen, die sie gesendet hat.Nach einem Formular-Submit, damit die Seite ihre Felder leert.
Partial ContentDer Server liefert nur den angeforderten Teil der Ressource.Ausliefern eines Byte-Bereichs aus einer Range-Anfrage.
3xx Umleitung
Moved PermanentlyDie Ressource hat eine dauerhaft neue URL; künftige Anfragen sollten sie verwenden.Eine Seite ist umgezogen und Suchmaschinen müssen ihren Index aktualisieren.
FoundDie Ressource liegt vorübergehend unter einer anderen URL, aber die ursprüngliche bleibt maßgeblich.Kurze Umleitung auf eine Login-Seite.
See OtherDie Antwort liegt unter einer anderen URL und muss mit GET geholt werden.Das PRG-Muster: einen POST auf eine Ergebnisseite umleiten, damit ein Reload nicht erneut absendet.
Not ModifiedDie zwischengespeicherte Kopie ist noch gültig; der Server sendet keinen Body.Conditional GET, bei dem der Cache des Clients aktuell ist.
Use ProxyDie Anfrage muss über den in der Antwort genannten Proxy gesendet werden.Alt-Proxy-Netzwerke; seit 2011 veraltet.
Temporary RedirectDie Ressource liegt vorübergehend woanders; die ursprüngliche Anfragemethode muss erhalten bleiben.Wie 302, aber ein POST bleibt beim Redirect ein POST.
Permanent RedirectDie Ressource hat eine dauerhaft neue URL; die ursprüngliche Anfragemethode muss erhalten bleiben.Wie 301, aber ein POST bleibt beim Redirect ein POST.
4xx Clientfehler
Bad RequestDer Server konnte die Anfrage wegen fehlerhafter Syntax nicht verstehen.Ungültiges JSON oder ein fehlendes Pflichtfeld.
UnauthorizedAuthentifizierung ist erforderlich; sie fehlte oder ist gescheitert.Kein Token, oder ein ungültiges bzw. abgelaufenes Token.
Payment RequiredDie Anfrage erfordert Zahlung, obwohl die Spezifikation nie definiert hat, wie.Manche APIs nutzen ihn als Paywall-Marker; die meisten nutzen ihn nie.
ForbiddenDer Client ist authentifiziert, darf aber nicht auf diese Ressource zugreifen.Gültiger Login, aber keine Berechtigung für diese Ressource.
Not FoundDer Server hat unter dieser URL keine Ressource.Unbekannte URL oder eine ID, die nicht existiert.
Method Not AllowedDie URL existiert, erlaubt aber die verwendete Anfragemethode nicht.Ein POST gegen einen Endpunkt, der nur GET akzeptiert.
Not AcceptableDer Server kann keinen Inhalt liefern, der zu den Accept-Headern des Clients passt.Der Client wollte nur XML, die API liefert aber nur JSON.
Proxy Authentication RequiredDer Client muss sich beim Proxy authentifizieren, bevor die Anfrage weitergeht.Ein Firmen-Proxy lehnt eine unauthentifizierte Anfrage ab.
Request TimeoutDer Client brauchte zu lange zum Senden und der Server gab auf.Ein Upload, der abbrach, bevor der Body vollständig ankam.
ConflictDie Anfrage kollidiert mit dem aktuellen Zustand der Ressource.Eine doppelte E-Mail oder ein Bearbeitungsrennen auf demselben Datensatz.
GoneDie Ressource existierte einmal, wurde aber dauerhaft entfernt.Ein bewusst stillgelegter Endpunkt, stärker als 404.
Length RequiredDie Anfrage braucht einen Content-Length-Header und hat keinen.Ein Server, der die Größe vorab wissen muss, lehnt einen gestreamten Body ab.
Precondition FailedEine Header-Vorbedingung wie If-Match ergab falsch.Eine optimistische Bearbeitung, bei der sich der Datensatz seit dem Lesen geändert hat.
Content Too LargeDer Anfrage-Body überschreitet das vom Server akzeptierte Limit.Ein Upload, der größer ist als die maximale Body-Größe des Servers.
URI Too LongDie Anfrage-URL ist länger, als der Server zu interpretieren bereit ist.Ein Formular, das versehentlich in einen GET-Query-String serialisiert wurde, der endlos wuchs.
Unsupported Media TypeDas Format des Anfrage-Bodys gehört nicht zu den vom Endpunkt akzeptierten.Ein POST mit Content-Type text/plain gegen einen Nur-JSON-Endpunkt.
Range Not SatisfiableDer Byte-Bereich im Range-Header passt nicht zur Ressource.Anfrage von Bytes hinter dem Dateiende beim Fortsetzen eines Downloads.
Expectation FailedDer Server kann die im Expect-Header genannte Erwartung nicht erfüllen.Eine 100-continue-Erwartung, die der Server verweigert.
I'm a teapotDer Server ist eine Teekanne und weigert sich, Kaffee zu brühen.Ein Aprilscherz von 1998, der nicht stirbt; APIs geben ihn zum Spaß zurück.
Misdirected RequestDie Anfrage ging an einen Server, der dafür keine Antwort erzeugen kann.Eine wiederverwendete Verbindung zu einem Host, den dieser Server nicht bedient.
Unprocessable EntityDie Anfrage ist wohlgeformt, aber ihre Werte bestehen die semantische Validierung nicht.Gültiges JSON, dessen Felder gegen Geschäftsregeln verstoßen.
Too EarlyDer Server lehnt eine Anfrage ab, die ein Replay-Risiko birgt.Abweisung einer wiederholten nicht-idempotenten Anfrage, bevor Schlüssel rotiert sind.
Upgrade RequiredDer Client muss für diese Ressource auf ein anderes Protokoll wechseln.Ein Endpunkt, der auf TLS oder WebSocket besteht.
Precondition RequiredDer Server verlangt konditionale Header, die die Anfrage nicht gesendet hat.Eine API, die If-Match verlangt, um verlorene Updates zu verhindern.
Too Many RequestsDer Client hat in einem Zeitfenster zu viele Anfragen gesendet.Ein Rate-Limit wurde erreicht; Abstand halten und erneut versuchen.
Request Header Fields Too LargeEin oder mehrere Header-Felder sind zu groß für die Verarbeitung durch den Server.Ein Cookie oder Token, das so weit wuchs, dass es jede Anfrage an die Site blockierte.
Unavailable For Legal ReasonsDie Ressource ist aus rechtlichen Gründen blockiert, etwa durch eine Takedown- oder Geo-Sperre.Eine behördliche Takedown-Aufforderung oder eine in einem Land gesperrte Seite.
5xx Serverfehler
Internal Server ErrorDer Server stieß auf eine unerwartete Bedingung und scheiterte.Eine unbehandelte Ausnahme oder ein Bug auf dem Server.
Not ImplementedDer Server unterstützt die angeforderte Methode oder das Feature nicht.Ein Endpunkt ist deklariert, aber noch nicht gebaut.
Bad GatewayEin Gateway oder Proxy erhielt eine ungültige Antwort vom Upstream-Server.Ein Reverse-Proxy erreichte das Backend nicht.
Service UnavailableDer Server kann die Anfrage vorübergehend nicht bearbeiten.Wartung, Überlastung oder ein ausgefallener abhängiger Dienst.
Gateway TimeoutEin Gateway oder Proxy erhielt rechtzeitig keine Antwort vom Upstream-Server.Das Backend brauchte zu lange und der Proxy gab auf.
HTTP Version Not SupportedDer Server unterstützt die HTTP-Version der Anfrage nicht.Ein Client spricht eine Protokollversion, die der Server nie gelernt hat.
Variant Also NegotiatesDie transparente Inhaltsverhandlung endete in einer zirkulären Referenz.Ein falsch konfigurierter Server mit experimenteller Content-Negotiation.
Insufficient StorageDer Server kann die Repräsentation nicht speichern, die die Anfrage benötigt.Ein WebDAV-Server, dessen zugewiesener Speicher voll ist.
Loop DetectedDer Server geriet bei der Verarbeitung der Anfrage in eine Endlosschleife.Eine WebDAV-Bindung, die auf sich selbst verweist.
Network Authentication RequiredDer Client muss sich beim Netzwerk authentifizieren, um Zugang zu erhalten.Ein Captive Portal in einem Hotel oder Flughafen fängt die Anfrage ab.