HTTP-Statuscode-Referenz
Schlagen Sie nach, was ein HTTP-Statuscode bedeutet.
| 100 | Continue | Der Anfangsteil der Anfrage wurde empfangen; der Client sollte mit dem Rest der Anfrage fortfahren. |
| 101 | Switching Protocols | Der Server wechselt das Protokoll gemäß der Anfrage des Clients, z. B. ein Upgrade auf WebSocket. |
| 102 | Processing | Der Server hat die vollständige Anfrage angenommen, deren Verarbeitung aber noch nicht abgeschlossen (WebDAV). |
| 103 | Early Hints | Ermöglicht es dem Client, Ressourcen bereits vorzuladen, während der Server die endgültige Antwort vorbereitet. |
| 200 | OK | Die Anfrage war erfolgreich, und der Antworttext enthält die angeforderte Ressource. |
| 201 | Created | Die Anfrage war erfolgreich, und als Ergebnis wurde eine neue Ressource erstellt. |
| 202 | Accepted | Die Anfrage wurde zur Verarbeitung angenommen, die Verarbeitung ist aber noch nicht abgeschlossen. |
| 203 | Non-Authoritative Information | Die zurückgegebenen Metadaten stammen nicht vom Ursprungsserver, sondern aus einer Kopie eines Drittanbieters oder des lokalen Caches. |
| 204 | No Content | Die Anfrage war erfolgreich, es gibt jedoch keinen Inhalt zurückzugeben. |
| 205 | Reset Content | Die Anfrage war erfolgreich; der Client sollte die Dokumentansicht zurücksetzen, von der die Anfrage gesendet wurde. |
| 206 | Partial Content | Es wird nur ein Teil der Ressource geliefert, passend zu einer Byte-Bereichsanfrage. |
| 207 | Multi-Status | Vermittelt Informationen über mehrere Ressourcen in Situationen, in denen mehrere Statuscodes angemessen sein könnten (WebDAV). |
| 208 | Already Reported | Die Mitglieder einer WebDAV-Bindung wurden bereits in einem vorherigen Teil der Antwort aufgeführt. |
| 226 | IM Used | Der Server hat eine Anfrage unter Verwendung einer oder mehrerer Instanzmanipulationen erfüllt. |
| 300 | Multiple Choices | Für die Anfrage gibt es mehr als eine mögliche Antwort; der Client sollte eine davon auswählen. |
| 301 | Moved Permanently | Die Ressource wurde dauerhaft an eine in der Antwort angegebene neue URL verschoben. |
| 302 | Found | Die Ressource befindet sich vorübergehend an einer anderen URL; künftige Anfragen sollten weiterhin die ursprüngliche URL verwenden. |
| 303 | See Other | Die Antwort ist über eine andere URL mithilfe einer GET-Anfrage zu finden. |
| 304 | Not Modified | Die Ressource hat sich seit der in den Cache-Headern des Clients angegebenen Version nicht geändert. |
| 307 | Temporary Redirect | Die Ressource befindet sich vorübergehend an einer anderen URL; anders als bei 302 muss die ursprüngliche Anfragemethode wiederverwendet werden. |
| 308 | Permanent Redirect | Die Ressource wurde dauerhaft an eine neue URL verschoben; die ursprüngliche Anfragemethode muss wiederverwendet werden. |
| 400 | Bad Request | Der Server konnte die Anfrage aufgrund ungültiger Syntax nicht verstehen. |
| 401 | Unauthorized | Eine Authentifizierung ist erforderlich und entweder fehlgeschlagen oder wurde nicht bereitgestellt. |
| 402 | Payment Required | Für zukünftige Verwendung reserviert; ursprünglich für digitale Zahlungssysteme gedacht. |
| 403 | Forbidden | Der Client hat keine Zugriffsrechte auf den Inhalt, obwohl die Anfrage verstanden wurde. |
| 404 | Not Found | Der Server kann die angeforderte Ressource nicht finden. |
| 405 | Method Not Allowed | Die Anfragemethode ist bekannt, wird aber von der Zielressource nicht unterstützt. |
| 406 | Not Acceptable | Der Server kann keine Antwort erzeugen, die den Accept-Headern des Clients entspricht. |
| 407 | Proxy Authentication Required | Vor der Fortsetzung der Anfrage ist eine Authentifizierung bei einem Proxy erforderlich. |
| 408 | Request Timeout | Beim Warten auf die Anfrage des Clients ist beim Server eine Zeitüberschreitung aufgetreten. |
| 409 | Conflict | Die Anfrage steht im Konflikt mit dem aktuellen Zustand der Zielressource. |
| 410 | Gone | Die angeforderte Ressource ist nicht mehr verfügbar und wurde dauerhaft entfernt. |
| 411 | Length Required | Der Server benötigt einen Content-Length-Header, der in der Anfrage fehlte. |
| 412 | Precondition Failed | Eine in den Anfrage-Headern angegebene Voraussetzung wurde vom Server nicht erfüllt. |
| 413 | Payload Too Large | Der Anfragetext ist größer, als der Server verarbeiten kann oder möchte. |
| 414 | URI Too Long | Die angeforderte URI ist länger, als der Server zu interpretieren bereit ist. |
| 415 | Unsupported Media Type | Das Medienformat der Anfrage wird vom Server nicht unterstützt. |
| 416 | Range Not Satisfiable | Der angeforderte Byte-Bereich kann angesichts der Größe der Ressource nicht erfüllt werden. |
| 417 | Expectation Failed | Der Server kann die im Expect-Header der Anfrage angegebene Erwartung nicht erfüllen. |
| 418 | I'm a Teapot | Ein scherzhafter Status, der in RFC 2324 als Aprilscherz definiert wurde; Server sollten keinen Kaffee kochen. |
| 421 | Misdirected Request | Die Anfrage wurde an einen Server gesendet, der keine Antwort für die Ziel-URI erzeugen kann. |
| 422 | Unprocessable Content | Die Anfrage war syntaktisch korrekt, enthält aber semantische Fehler, die die Verarbeitung verhindern. |
| 423 | Locked | Die aufgerufene Ressource ist gesperrt (WebDAV). |
| 424 | Failed Dependency | Die Anfrage ist fehlgeschlagen, weil sie von einer anderen, fehlgeschlagenen Anfrage abhing (WebDAV). |
| 425 | Too Early | Der Server ist nicht bereit, eine Anfrage zu verarbeiten, die wiederholt (replayed) werden könnte. |
| 426 | Upgrade Required | Der Client sollte zu einem anderen, im Upgrade-Header angegebenen Protokoll wechseln. |
| 428 | Precondition Required | Der Ursprungsserver verlangt, dass die Anfrage bedingt ist. |
| 429 | Too Many Requests | Der Client hat in einem bestimmten Zeitraum zu viele Anfragen gesendet (Ratenbegrenzung). |
| 431 | Request Header Fields Too Large | Der Server verarbeitet die Anfrage nicht, da ihre Header-Felder zu groß sind. |
| 451 | Unavailable For Legal Reasons | Die Ressource ist aus rechtlichen Gründen nicht verfügbar, etwa wegen staatlich angeordneter Zensur. |
| 500 | Internal Server Error | Beim Server ist ein unerwarteter Zustand aufgetreten, der die Erfüllung der Anfrage verhinderte. |
| 501 | Not Implemented | Der Server unterstützt die zur Erfüllung der Anfrage erforderliche Funktionalität nicht. |
| 502 | Bad Gateway | Der als Gateway fungierende Server hat eine ungültige Antwort von einem vorgelagerten Server erhalten. |
| 503 | Service Unavailable | Der Server ist nicht bereit, die Anfrage zu bearbeiten, oft wegen Wartungsarbeiten oder Überlastung. |
| 504 | Gateway Timeout | Der als Gateway fungierende Server hat keine rechtzeitige Antwort von einem vorgelagerten Server erhalten. |
| 505 | HTTP Version Not Supported | Die in der Anfrage verwendete HTTP-Version wird vom Server nicht unterstützt. |
| 506 | Variant Also Negotiates | Der Server weist einen internen Konfigurationsfehler bei der Content-Aushandlung auf. |
| 507 | Insufficient Storage | Der Server kann die zur Erfüllung der Anfrage erforderliche Repräsentation nicht speichern (WebDAV). |
| 508 | Loop Detected | Der Server hat bei der Verarbeitung der Anfrage eine Endlosschleife festgestellt (WebDAV). |
| 510 | Not Extended | Für die Erfüllung der Anfrage durch den Server sind weitere Erweiterungen erforderlich. |
| 511 | Network Authentication Required | Der 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.