HTTP-Statuscode-Referenz

Schlagen Sie nach, was ein HTTP-Statuscode bedeutet.

1xx Informativ
100ContinueDer Anfangsteil der Anfrage wurde empfangen; der Client sollte mit dem Rest der Anfrage fortfahren.
101Switching ProtocolsDer Server wechselt das Protokoll gemäß der Anfrage des Clients, z. B. ein Upgrade auf WebSocket.
102ProcessingDer Server hat die vollständige Anfrage angenommen, deren Verarbeitung aber noch nicht abgeschlossen (WebDAV).
103Early HintsErmöglicht es dem Client, Ressourcen bereits vorzuladen, während der Server die endgültige Antwort vorbereitet.
2xx Erfolg
200OKDie Anfrage war erfolgreich, und der Antworttext enthält die angeforderte Ressource.
201CreatedDie Anfrage war erfolgreich, und als Ergebnis wurde eine neue Ressource erstellt.
202AcceptedDie Anfrage wurde zur Verarbeitung angenommen, die Verarbeitung ist aber noch nicht abgeschlossen.
203Non-Authoritative InformationDie zurückgegebenen Metadaten stammen nicht vom Ursprungsserver, sondern aus einer Kopie eines Drittanbieters oder des lokalen Caches.
204No ContentDie Anfrage war erfolgreich, es gibt jedoch keinen Inhalt zurückzugeben.
205Reset ContentDie Anfrage war erfolgreich; der Client sollte die Dokumentansicht zurücksetzen, von der die Anfrage gesendet wurde.
206Partial ContentEs wird nur ein Teil der Ressource geliefert, passend zu einer Byte-Bereichsanfrage.
207Multi-StatusVermittelt Informationen über mehrere Ressourcen in Situationen, in denen mehrere Statuscodes angemessen sein könnten (WebDAV).
208Already ReportedDie Mitglieder einer WebDAV-Bindung wurden bereits in einem vorherigen Teil der Antwort aufgeführt.
226IM UsedDer Server hat eine Anfrage unter Verwendung einer oder mehrerer Instanzmanipulationen erfüllt.
3xx Weiterleitung
300Multiple ChoicesFür die Anfrage gibt es mehr als eine mögliche Antwort; der Client sollte eine davon auswählen.
301Moved PermanentlyDie Ressource wurde dauerhaft an eine in der Antwort angegebene neue URL verschoben.
302FoundDie Ressource befindet sich vorübergehend an einer anderen URL; künftige Anfragen sollten weiterhin die ursprüngliche URL verwenden.
303See OtherDie Antwort ist über eine andere URL mithilfe einer GET-Anfrage zu finden.
304Not ModifiedDie Ressource hat sich seit der in den Cache-Headern des Clients angegebenen Version nicht geändert.
307Temporary RedirectDie Ressource befindet sich vorübergehend an einer anderen URL; anders als bei 302 muss die ursprüngliche Anfragemethode wiederverwendet werden.
308Permanent RedirectDie Ressource wurde dauerhaft an eine neue URL verschoben; die ursprüngliche Anfragemethode muss wiederverwendet werden.
4xx Client-Fehler
400Bad RequestDer Server konnte die Anfrage aufgrund ungültiger Syntax nicht verstehen.
401UnauthorizedEine Authentifizierung ist erforderlich und entweder fehlgeschlagen oder wurde nicht bereitgestellt.
402Payment RequiredFür zukünftige Verwendung reserviert; ursprünglich für digitale Zahlungssysteme gedacht.
403ForbiddenDer Client hat keine Zugriffsrechte auf den Inhalt, obwohl die Anfrage verstanden wurde.
404Not FoundDer Server kann die angeforderte Ressource nicht finden.
405Method Not AllowedDie Anfragemethode ist bekannt, wird aber von der Zielressource nicht unterstützt.
406Not AcceptableDer Server kann keine Antwort erzeugen, die den Accept-Headern des Clients entspricht.
407Proxy Authentication RequiredVor der Fortsetzung der Anfrage ist eine Authentifizierung bei einem Proxy erforderlich.
408Request TimeoutBeim Warten auf die Anfrage des Clients ist beim Server eine Zeitüberschreitung aufgetreten.
409ConflictDie Anfrage steht im Konflikt mit dem aktuellen Zustand der Zielressource.
410GoneDie angeforderte Ressource ist nicht mehr verfügbar und wurde dauerhaft entfernt.
411Length RequiredDer Server benötigt einen Content-Length-Header, der in der Anfrage fehlte.
412Precondition FailedEine in den Anfrage-Headern angegebene Voraussetzung wurde vom Server nicht erfüllt.
413Payload Too LargeDer Anfragetext ist größer, als der Server verarbeiten kann oder möchte.
414URI Too LongDie angeforderte URI ist länger, als der Server zu interpretieren bereit ist.
415Unsupported Media TypeDas Medienformat der Anfrage wird vom Server nicht unterstützt.
416Range Not SatisfiableDer angeforderte Byte-Bereich kann angesichts der Größe der Ressource nicht erfüllt werden.
417Expectation FailedDer Server kann die im Expect-Header der Anfrage angegebene Erwartung nicht erfüllen.
418I'm a TeapotEin scherzhafter Status, der in RFC 2324 als Aprilscherz definiert wurde; Server sollten keinen Kaffee kochen.
421Misdirected RequestDie Anfrage wurde an einen Server gesendet, der keine Antwort für die Ziel-URI erzeugen kann.
422Unprocessable ContentDie Anfrage war syntaktisch korrekt, enthält aber semantische Fehler, die die Verarbeitung verhindern.
423LockedDie aufgerufene Ressource ist gesperrt (WebDAV).
424Failed DependencyDie Anfrage ist fehlgeschlagen, weil sie von einer anderen, fehlgeschlagenen Anfrage abhing (WebDAV).
425Too EarlyDer Server ist nicht bereit, eine Anfrage zu verarbeiten, die wiederholt (replayed) werden könnte.
426Upgrade RequiredDer Client sollte zu einem anderen, im Upgrade-Header angegebenen Protokoll wechseln.
428Precondition RequiredDer Ursprungsserver verlangt, dass die Anfrage bedingt ist.
429Too Many RequestsDer Client hat in einem bestimmten Zeitraum zu viele Anfragen gesendet (Ratenbegrenzung).
431Request Header Fields Too LargeDer Server verarbeitet die Anfrage nicht, da ihre Header-Felder zu groß sind.
451Unavailable For Legal ReasonsDie Ressource ist aus rechtlichen Gründen nicht verfügbar, etwa wegen staatlich angeordneter Zensur.
5xx Server-Fehler
500Internal Server ErrorBeim Server ist ein unerwarteter Zustand aufgetreten, der die Erfüllung der Anfrage verhinderte.
501Not ImplementedDer Server unterstützt die zur Erfüllung der Anfrage erforderliche Funktionalität nicht.
502Bad GatewayDer als Gateway fungierende Server hat eine ungültige Antwort von einem vorgelagerten Server erhalten.
503Service UnavailableDer Server ist nicht bereit, die Anfrage zu bearbeiten, oft wegen Wartungsarbeiten oder Überlastung.
504Gateway TimeoutDer als Gateway fungierende Server hat keine rechtzeitige Antwort von einem vorgelagerten Server erhalten.
505HTTP Version Not SupportedDie in der Anfrage verwendete HTTP-Version wird vom Server nicht unterstützt.
506Variant Also NegotiatesDer Server weist einen internen Konfigurationsfehler bei der Content-Aushandlung auf.
507Insufficient StorageDer Server kann die zur Erfüllung der Anfrage erforderliche Repräsentation nicht speichern (WebDAV).
508Loop DetectedDer Server hat bei der Verarbeitung der Anfrage eine Endlosschleife festgestellt (WebDAV).
510Not ExtendedFür die Erfüllung der Anfrage durch den Server sind weitere Erweiterungen erforderlich.
511Network Authentication RequiredDer Client muss sich authentifizieren, um Netzwerkzugang zu erhalten – häufig bei Captive-Portalen zu sehen.

Anwendungsbeispiele

Verstehen, was ein Statuscode einer API-Antwort bedeutet

Suchen Sie nach einem unbekannten Code wie 422, der von einer Backend-API zurückgegeben wurde, um schnell zu sehen, was er bedeutet und wie Sie darauf reagieren sollten.

Den richtigen Weiterleitungscode wählen

Prüfen Sie den Unterschied zwischen 301 und 308 oder 302 und 307, um zu entscheiden, welchen Weiterleitungsstatus Sie beim Verschieben einer URL verwenden sollten.

Einen im Netzwerk-Tab des Browsers gesehenen Code nachschlagen

Suchen Sie nach einem Statuscode, den Sie im Netzwerk-Tab der Entwicklertools Ihres Browsers gesehen haben, um zu verstehen, warum eine Anfrage fehlgeschlagen ist.

Beim Debuggen der Authentifizierung 401 und 403 unterscheiden

Suchen Sie nach '401' und '403' nebeneinander, um den genauen Unterschied zu sehen: 401 bedeutet, dass die Anfrage keine gültigen Zugangsdaten hat, 403 dagegen, dass die Zugangsdaten gültig sind, der Benutzer aber nicht auf die Ressource zugreifen darf.

Entscheiden, wie ein Client mit Ratenbegrenzung umgehen soll

Schlagen Sie 429 nach, um zu bestätigen, dass es zu viele Anfragen in einem bestimmten Zeitraum bedeutet, und prüfen Sie, ob die Antwort Ihrer API einen Retry-After-Header enthält, den Sie vor einem erneuten Versuch beachten sollten.

Häufig gestellte Fragen

Sind alle Codes in dieser Liste tatsächlich standardisiert?

Ja — diese Liste enthält nur Codes, die im offiziellen HTTP-Statuscode-Register der IANA eingetragen sind und gebräuchlich sind. Nicht standardisierte oder inoffizielle Codes sind nicht enthalten.

Warum fehlen Codes wie 305 und 306?

305 (Use Proxy) ist aus Sicherheitsgründen faktisch veraltet, und 306 wird nicht verwendet. Da Ihnen beide in der Praxis sehr wahrscheinlich nicht begegnen, konzentriert sich die Liste auf Codes, denen Sie tatsächlich begegnen werden.

Ersetzen diese Beschreibungen die vollständige Spezifikation oder eine Rechtsberatung?

Nein — dies sind kurze Zusammenfassungen für eine schnelle Nachschau. Wenn das genaue Verhalten wichtig ist, prüfen Sie direkt das entsprechende RFC oder die aktuelle HTTP-Spezifikation.

Was ist der eigentliche Unterschied zwischen 401 und 403?

401 Unauthorized bedeutet eigentlich „nicht authentifiziert“ – der Server weiß nicht, wer Sie sind, meist weil Zugangsdaten fehlen oder ungültig sind. 403 Forbidden bedeutet, dass der Server weiß, wer Sie sind, Sie aber auch mit gültigen Zugangsdaten keine Berechtigung für den Zugriff auf diese Ressource haben.

Sollte ich 404 oder 410 verwenden, wenn eine Ressource nicht mehr existiert?

Verwenden Sie 404 Not Found, wenn eine Ressource nicht existiert und Sie nicht wissen (oder nicht sagen wollen), ob es sie je gab. Verwenden Sie 410 Gone, wenn Sie sicher wissen, dass eine Ressource früher existierte, aber dauerhaft entfernt wurde – das signalisiert Clients und Suchmaschinen, sie nicht mehr anzufragen.

Wann sollte ich bei einer Weiterleitung 301, 302, 307 oder 308 verwenden?

301 und 308 sind permanente Weiterleitungen, 302 und 307 temporäre. Der Unterschied zwischen dem älteren Paar (301/302) und dem neueren (307/308) besteht darin, dass 307 und 308 garantieren, dass Anfragemethode und Body bei der weitergeleiteten Anfrage erhalten bleiben, während 301 und 302 Clients historisch erlauben, aus einem POST ein GET zu machen.

Warum hat mein Server 500 statt eines spezifischeren Codes zurückgegeben?

500 Internal Server Error ist ein allgemeiner Auffangcode für unerwartete serverseitige Fehler, etwa eine nicht behandelte Ausnahme. Meist bedeutet er, dass die Fehlerbehandlung des Servers den Fehler keinem spezifischeren 4xx- oder 5xx-Code zugeordnet hat – prüfen Sie Ihre Server-Logs auf die tatsächliche Ursache.