HTTP/Statuscode
HTTP-Statuscode -
Beschreibung
Jede HTTP-Anfrage wird vom Server mit einem HTTP-Statuscode beantwortet
- ob die Anfrage erfolgreich bearbeitet wurde
- teilt dem Client/Browser im Fehlerfall mit, wo (etwa Umleitung) oder wie (zum Beispiel mit Authentifizierung) er die gewünschten Informationen (wenn möglich) erhalten kann
- HTTP-Statuscode
Ein HTTP-Statuscode wird von einem Server auf jede HTTP-Anfrage als Antwort geliefert.
- Auf der anfragenden Seite steht dabei ein Client wie ein Webbrowser.
- Der Server teilt durch den HTTP-Statuscode dem Client mit, ob die Anfrage erfolgreich bearbeitet wurde.
- Im Fehlerfall gibt der Statuscode Auskunft darüber, wo (beispielsweise über eine Umleitung) oder wie (zum Beispiel mit Authentifizierung) er die gewünschten Informationen erhalten kann.
- 404: „Nicht gefunden“
- Am bekanntesten sind dabei die Codes 404: „Nicht gefunden“, 403: „Fehlende Zugriffsberechtigung“ und 400: „Fehlerhafte Anfrage“
- Statusklassen
Die erste Ziffer eines Statuscodes stellt die Statusklasse dar.
- Sie sind in RFC 7231 (ersetzt RFC 2616), sowie RFC 2518, RFC 2817, RFC 2295, RFC 2774 und RFC 4918 spezifiziert.
- Einige gehören zum Distributed Authoring (WebDAV)
Neben den in RFC standardisierten Statuscodes verwenden manche Softwarehersteller auch proprietäre Codes für eigens definierte Status- und Fehlermeldungen.
- Andere Software kann dem Benutzer diese Codes nur als allgemeinen unbekannten Fehler anzeigen; nicht aber eine Übersetzung und Hinweise zum weiteren Vorgehen.
- Teilweise können die Server den Begleitumständen der Anfrage bereits entnehmen, dass es sich um die zugehörige Spezialsoftware handelt, und geben nur dann die proprietären Codes zurück.
- In diesem Artikel sind einige proprietäre Codes aufgeführt und entsprechend gekennzeichnet
| Codes | Klasse | Beschreibung |
|---|---|---|
| 1xx | Informationen | Die Bearbeitung der Anfrage dauert trotz der Rückmeldung noch an
|
| 2xx | Erfolg | Die Anfrage wurde bearbeitet und die Antwort wird an den Anfragesteller zurückgesendet |
| 3xx | Umleitung | Um eine erfolgreiche Bearbeitung der Anfrage sicherzustellen, sind weitere Schritte seitens des Clients erforderlich
|
| 4xx | Client-Fehler | Bei der Bearbeitung der Anfrage ist ein Fehler aufgetreten, der im Verantwortungsbereich des Clients liegt
|
| 5xx | Server-Fehler | Es ist ein Fehler aufgetreten, dessen Ursache beim Server liegt
|
| 9xx | Proprietäre Fehler |
Zusätzlich zum Statuscode enthält der Header der Server-Antwort eine Beschreibung des Fehlers in englischsprachigem Klartext
Zum Beispiel ist ein Fehler 404 an folgendem Header zu erkennen:
HTTP/1.1 404 Not Found
…
HTTP-Statuscodes
1xx – Informationen
Die Bearbeitung der Anfrage dauert noch an
| Code | Nachricht | Bedeutung |
|---|---|---|
| 100 | Continue | Die laufende Anfrage an den Server wurde noch nicht zurückgewiesen. (Wird im Zusammenhang mit dem „Expect 100-continue“-Header-Feld verwendet.) Der Client kann nun mit der potentiell sehr großen Anfrage fortfahren |
| 101 | Switching Protocols | Wird verwendet, wenn der Server eine Anfrage mit gesetztem „Upgrade“-Header-Feld empfangen hat und mit dem Wechsel zu einem anderen Protokoll einverstanden ist.
|
| 102 | Processing | Wird verwendet, um ein Timeout zu vermeiden, während der Server eine zeitintensive Anfrage bearbeitet.
|
| 103 | Early Hints | Wird zusammen mit dem „Link“ Header verwendet, um das Vorladen von Ressourcen zu ermöglichen, während der Server die finale Antwort noch vorbereitet |
2xx – Erfolgreiche Operation
Die Anfrage war erfolgreich, die Antwort kann verwertet werden
| Code | Nachricht | Bedeutung |
|---|---|---|
| 200 | OK | Die Anfrage wurde erfolgreich bearbeitet und das Ergebnis der Anfrage wird in der Antwort übertragen |
| 201 | Created | Die Anfrage wurde erfolgreich bearbeitet.
|
| 202 | Accepted | Die Anfrage wurde akzeptiert, wird aber zu einem späteren Zeitpunkt ausgeführt.
|
| 203 | Non-Authoritative Information | Der Server agiert als „Transforming Proxy“, erhielt eine 200 OK Antwort von der Quelle und antwortet mit einem veränderten Dokument der Quelle |
| 204 | No Content | Die Anfrage wurde erfolgreich durchgeführt, die Antwort enthält jedoch bewusst keine Daten |
| 205 | Reset Content | Die Anfrage wurde erfolgreich durchgeführt; der Client soll das Dokument neu aufbauen und Formulareingaben zurücksetzen |
| 206 | Partial Content | Der angeforderte Teil wurde erfolgreich übertragen (wird im Zusammenhang mit einem „Content-Range“-Header-Feld oder dem Content-Type multipart/byteranges verwendet).
|
| 207 | Multi-Status | WebDAV RFC 4918 – Die Antwort enthält ein in WebDAV spezifiziertes XML-Dokument, das mehrere Statuscodes zu unabhängig voneinander durchgeführten Operationen enthält |
| 208 | Already Reported | WebDAV RFC 5842 – Die Mitglieder einer WebDAV-Bindung wurden bereits zuvor aufgezählt und sind in dieser Anfrage nicht mehr vorhanden |
| 226 | IM Used | RFC 3229 – Der Server hat eine GET-Anforderung für die Ressource erfüllt, die Antwort ist eine Darstellung des Ergebnisses von einer oder mehrerer Instanz-Manipulationen, bezogen auf die aktuelle Instanz |
3xx – Umleitung
Um eine erfolgreiche Bearbeitung der Anfrage sicherzustellen, sind weitere Schritte seitens des Clients erforderlich
| Code | Nachricht | Bedeutung |
|---|---|---|
| 300 | Multiple Choices | Die angeforderte Ressource steht in verschiedenen Arten zur Verfügung.
|
| 301 | Moved Permanently | Die angeforderte Ressource steht ab sofort unter der im „Location“-Header-Feld angegebenen Adresse bereit (auch Redirect genannt).
|
| 302 | en|Moved Temporarily) | Die angeforderte Ressource steht vorübergehend unter der im „Location“-Header-Feld angegebenen Adresse bereit.
|
| 303 | See Other | Die Antwort auf die durchgeführte Anfrage lässt sich unter der im „Location“-Header-Feld angegebenen Adresse beziehen.
|
| 304 | Not Modified | Der Inhalt der angeforderten Ressource hat sich seit der letzten Abfrage des Clients nicht verändert und wird deshalb nicht übertragen.
|
| 305 | Use Proxy | Die angeforderte Ressource ist nur über einen Proxy erreichbar.
|
| 306 | (reserviert) | 306 wird nicht mehr verwendet, ist aber reserviert.
|
| 307 | Temporary Redirect | Die angeforderte Ressource steht vorübergehend unter der im „Location“-Header-Feld angegebenen Adresse bereit.
|
| 308 | Permanent Redirect | Die angeforderte Ressource steht ab sofort unter der im „Location“-Header-Feld angegebenen Adresse bereit, die alte Adresse ist nicht länger gültig.
|
4xx – Client-Fehler
Die Ursache des Scheiterns der Anfrage liegt (eher) im Verantwortungsbereich des Clients
| Code | Nachricht | Bedeutung |
|---|---|---|
| 400 | Bad Request | Die Anfrage-Nachricht war fehlerhaft aufgebaut |
| 401 | Unauthorized | Die Anfrage kann nicht ohne gültige Authentifizierung durchgeführt werden.
|
| 402 | Payment Required | Bezahlung benötigt.
|
| 403 | Forbidden | Die Anfrage wurde mangels Berechtigung des Clients nicht durchgeführt, bspw.
|
| 404 | Not Found | Die angeforderte Ressource wurde nicht gefunden.
|
| 405 | Method Not Allowed | Die Anfrage darf nur mit anderen HTTP-Methoden (zum Beispiel GET statt POST) gestellt werden.
|
| 406 | Not Acceptable | Die angeforderte Ressource steht nicht in der gewünschten Form zur Verfügung.
|
| 407 | Proxy Authentication Required | Analog zum Statuscode 401 ist hier zunächst eine Authentifizierung des Clients gegenüber dem verwendeten Proxy erforderlich.
|
| 408 | Request Timeout | Innerhalb der vom Server erlaubten Zeitspanne wurde keine vollständige Anfrage des Clients empfangen |
| 409 | Conflict | Die Anfrage wurde unter falschen Annahmen gestellt.
|
| 410 | Gone | Die angeforderte Ressource wird nicht länger bereitgestellt und wurde dauerhaft entfernt |
| 411 | Length Required | Die Anfrage kann ohne ein „Content-Length“-Header-Feld nicht bearbeitet werden |
| 412 | Precondition Failed | Eine in der Anfrage übertragene Voraussetzung, zum Beispiel in Form eines „If-Match“-Header-Felds, traf nicht zu |
| 413 | Payload Too Large | Die gestellte Anfrage war zu groß, um vom Server bearbeitet werden zu können.
|
| 414 | URI Too Long | Die URL der Anfrage war zu lang.
|
| 415 | Unsupported Media Type | Der Inhalt der Anfrage wurde mit ungültigem oder nicht erlaubtem Medientyp übermittelt |
| 416 | Range Not Satisfiable | Der angeforderte Teil einer Ressource war ungültig oder steht auf dem Server nicht zur Verfügung |
| 417 | Expectation Failed | Verwendet im Zusammenhang mit einem „Expect“-Header-Feld.
|
| 421 | Misdirected Request | Die Anfrage wurde an einen Server gesendet, der nicht in der Lage ist, eine Antwort zu senden.
|
| 422 | Unprocessable Entity | Verwendet, wenn weder die Rückgabe von Statuscode 415 noch 400 gerechtfertigt wäre, eine Verarbeitung der Anfrage jedoch zum Beispiel wegen semantischer Fehler abgelehnt wird |
| 423 | Locked | Die angeforderte Ressource ist zurzeit gesperrt |
| 424 | Failed Dependency | Die Anfrage konnte nicht durchgeführt werden, weil sie das Gelingen einer anderen Anfrage voraussetzt |
| 425 | Too Early | Der Server bittet den Client die Anfrage erneut zu senden, da die TLS-Verbindung noch nicht vollständig hergestellt wurde.
|
| 426 | Upgrade Required | Der Server verlangt vom Client, dass er die Anfrage mit einem anderen Protokoll wiederholt |
| 428 | Precondition Required | Für die Anfrage waren nicht alle Vorbedingungen erfüllt.
|
| 429 | Too Many Requests | Der Client hat zu viele Anfragen in einem bestimmten Zeitraum gesendet |
| 431 | Request Header Fields Too Large | Die Maximallänge eines Headerfelds oder des Gesamtheaders wurde überschritten |
| 451 | Unavailable For Legal Reasons | Dieser Statuscode soll darauf hinweisen, dass die angeforderte Ressource aufgrund von gesetzlichen Bestimmungen (Copyrighteinschränkungen, Zensur etc., eventuell beschränkt auf ein bestimmtes Land) nicht verfügbar ist
Er wurde im Juni 2012 von Google-Mitarbeiter Tim Bray bei der IETF eingereicht und gilt seit dem 17.
Bray schlug die Nummer 451 in Anspielung auf Ray Bradburys Roman Fahrenheit 451 vor und fügte einen Dank an den Autor an |
| Beispiele für weitere, per Juli 2020 nicht in der Hypertext Transfer Protocol (HTTP) Status Code Registry aufgeführte Codes: | ||
| 418 | I’m a teapot | Dieser Code ist als Aprilscherz der IETF zu verstehen.
zeigt er an, dass fälschlicherweise eine Teekanne anstatt einer Kaffeekanne verwendet wurde.
|
| 420 | Policy Not Fulfilled | In W3C PEP (Working Draft 21.
|
| 444 | No Response | In nginx-Logs verwendet, um anzuzeigen, dass der Server keine Informationen zum Client zurückgesendet und die Verbindung geschlossen hat |
| 449 | The request should be retried after doing the appropriate action | Genutzt in Antworten des Microsoft Exchange Servers |
| 499 | Client Closed Request | Ein nicht standardmäßiger Statuscode, der von nginx für den Fall eingeführt wurde, dass ein Client die Verbindung schließt, während nginx die Anforderung verarbeitet |
5xx – Server-Fehler
Nicht klar von den so genannten Client-Fehlern abzugrenzen.
- Die Ursache des Scheiterns der Anfrage liegt jedoch eher im Verantwortungsbereich des Servers
| Code | Nachricht | Bedeutung |
|---|---|---|
| 500 | Internal Server Error | Dies ist ein „Sammel-Statuscode“ für unerwartete Serverfehler |
| 501 | Not Implemented | Die Funktionalität, um die Anfrage zu bearbeiten, wird von diesem Server nicht bereitgestellt.
|
| 502 | Bad Gateway | Der Server konnte seine Funktion als Gateway oder Proxy nicht erfüllen, weil er seinerseits eine ungültige Antwort erhalten hat |
| 503 | Service Unavailable | Der Server steht temporär nicht zur Verfügung, zum Beispiel wegen Überlastung oder Wartungsarbeiten.
|
| 504 | Gateway Timeout | Der Server konnte seine Funktion als Gateway oder Proxy nicht erfüllen, weil er innerhalb einer festgelegten Zeitspanne keine Antwort von seinerseits benutzten Servern oder Diensten erhalten hat |
| 505 | HTTP Version not supported | Die benutzte HTTP-Version (gemeint ist die Zahl vor dem Punkt) wird vom Server nicht unterstützt oder abgelehnt |
| 506 | Variant Also Negotiates | Die Inhaltsvereinbarung der Anfrage ergibt einen Zirkelbezug |
| 507 | Insufficient Storage | Die Anfrage konnte nicht bearbeitet werden, weil der Speicherplatz des Servers dazu derzeit nicht mehr ausreicht |
| 508 | Loop Detected | Die Operation wurde nicht ausgeführt, weil die Ausführung in eine Endlosschleife gelaufen wäre.
|
| 509 | Bandwidth Limit Exceeded | Die Anfrage wurde verworfen, weil sonst die verfügbare Bandbreite überschritten würde (inoffizielle Erweiterung einiger Server) |
| 510 | Not Extended | Die Anfrage enthält nicht alle Informationen, welche die angefragte Server-Extension zwingend erwartet |
| 511 | Network Authentication Required | Der Client muss sich zuerst authentifizieren, um Zugang zum Netzwerk zu erhalten |
9xx – Proprietäre Fehler
Manche Softwarehersteller verwenden den Bereich ab 900 für proprietäre Statuscodes Dieser Zahlenbereich wurde in den RFC-Dokumenten nie erwähnt und liegt offensichtlich jenseits der standardisierten Codes.
- Dadurch ist er leicht als Sonderfall erkennbar
Anhang
Siehe auch
Links
Weblinks
- Hypertext Transfer Protocol (HTTP) Status Code Registry auf der Website der IANA
- Microsoft Internet Information Server Status Codes and Sub-Codes bei support.microsoft.com
- apache-status-code-headers bei askapache.com
- Roy Fielding, Julian Reschke: Section 6.3.4 – Response Status Codes.
- RFC 7231 – Hypertext Transfer Protocol (HTTP/1.1), IETF, Juni 2014