Zum Hauptinhalt springen

HTTP-Statuscode-Referenz – kostenlos

Durchsuchbare Referenz für alle HTTP-Statuscodes – was jeder bedeutet, wann er verwendet wird und häufige Ursachen. Von 100 bis 511.

Funktioniert nach dem Laden offline

61 Statuscodes

100

Fortfahren

Der Server hat die Anfrage-Header empfangen und der Client sollte mit dem Text fortfahren.

Wird für Anfragen mit Expect: 100-continue verwendet. Der Server bestätigt, dass er bereit ist, den Text zu empfangen, bevor der Client ihn sendet. In modernen Web-Apps selten zu sehen.

RFC 9110 ↗
101

Protokolle wechseln

Der Server wechselt die Protokolle wie vom Client angefordert.

Wird am häufigsten für WebSocket-Upgrades verwendet — der Client fordert Upgrade: websocket an und der Server antwortet mit 101 zum Umschalten.

RFC 9110 ↗
102

Verarbeitung

Der Server hat die Anfrage empfangen und verarbeitet sie, aber es ist noch keine Antwort verfügbar.

Eine WebDAV-Zwischenantwort, die gesendet wird, um Client-Timeouts bei längeren Operationen zu vermeiden. Veraltet — moderne Server sollten sie nicht senden.

RFC 2518 ↗
103

Frühe Hinweise

Vorläufige Header vor der endgültigen Antwort.

Ermöglicht es Servern, Link-Header (preload/preconnect) zu senden, während die endgültige Antwort noch vorbereitet wird, damit Browser kritische Assets früher abrufen können.

RFC 8297 ↗
200

OK

Die Anfrage war erfolgreich.

Die Standard-Erfolgsmeldung. Die Bedeutung hängt von der HTTP-Methode ab: GET → Ressource zurückgegeben, POST/PUT → Aktion abgeschlossen.

RFC 9110 ↗
201

Erstellt

Eine neue Ressource wurde erfolgreich erstellt.

Häufig nach einem POST. Die Antwort sollte einen Location-Header enthalten, der auf die URL der neuen Ressource verweist.

RFC 9110 ↗
202

Akzeptiert

Die Anfrage wurde zur Verarbeitung akzeptiert, aber die Verarbeitung ist nicht abgeschlossen.

Für asynchrone Operationen — der Server stellt die Arbeit in eine Warteschlange. Der Client sollte einen Status-Endpoint abfragen oder später zurückkehren.

RFC 9110 ↗
203

Nicht autoritative Informationen

Die Antwort wurde durch einen transformierenden Proxy geändert.

Die Anfrage war erfolgreich, aber eine Zwischenstelle (z. B. ein cachender oder transformierender Proxy) hat die Payload vom Origin-Server geändert — beispielsweise Bilder neu komprimiert. In der Praxis selten.

RFC 9110 ↗
204

Kein Inhalt

Die Anfrage war erfolgreich, aber es gibt keinen Antwortkörper.

Wird häufig bei DELETE-Operationen oder PUT-Updates verwendet, die keinen Text zurückgeben müssen. Der Client sollte nicht von der aktuellen Seite wegnavigieren.

RFC 9110 ↗
205

Inhalt zurücksetzen

Die Anfrage war erfolgreich; der Client sollte die Dokumentansicht zurücksetzen.

Wie 204, es wird kein Text zurückgegeben — aber dem Client wird zusätzlich mitgeteilt, das Formular oder die Ansicht zurückzusetzen, das/die die Anfrage erzeugt hat (z. B. die Formularfelder für den nächsten Eintrag löschen).

RFC 9110 ↗
206

Teilinhalt

Der Server hat nur einen Teil der Ressource bereitgestellt.

Antwort auf eine Range-Anfrage. Wird von Video-Playern und Download-Managern verwendet, um unterbrochene Downloads fortzusetzen oder große Dateien zu streamen.

RFC 9110 ↗
207

Multi-Status

Der Antwortkörper enthält mehrere Statuscodes für mehrere Operationen.

WebDAV: ein XML-Text meldet das Ergebnis mehrerer Teiloperationen unabhängig — z. B. ein Batch-Verschieben, bei dem einige Elemente erfolgreich waren und andere fehlgeschlagen sind.

RFC 4918 ↗
208

Bereits gemeldet

Die Mitglieder einer Sammlung wurden bereits früher in der Antwort aufgelistet.

WebDAV: wird in 207 Multi-Status-Antworten verwendet, um zu vermeiden, dass Mitglieder derselben Sammlung wiederholt aufgelistet werden, wenn Bindungen Schleifen erzeugen.

RFC 5842 ↗
226

IM verwendet

Die Antwort ist das Ergebnis von Instanzmanipulationen, die auf die Ressource angewendet werden.

Delta-Codierung: Der Server gibt einen Unterschied zu einer vorherigen Version zurück, statt der vollständigen Ressource, um Bandbreite zu sparen. Sehr selten implementiert.

RFC 3229 ↗
300

Mehrere Auswahlmöglichkeiten

Mehrere Darstellungen der Ressource sind verfügbar.

Der Server bietet mehrere Optionen an (z. B. verschiedene Formate oder Sprachen) und der Client sollte eine auswählen. Selten verwendet, da automatische Content-Negotiation dies normalerweise handhabt.

RFC 9110 ↗
301

Dauerhaft verschoben

Die Ressource wurde dauerhaft zu einer neuen URL verschoben.

Verwenden Sie für permanente URL-Änderungen — Suchmaschinen aktualisieren ihren Index. SEO-Autorität wird auf die neue URL übertragen.

RFC 9110 ↗
302

Gefunden (temporäre Umleitung)

Die Ressource befindet sich vorübergehend unter einer anderen URL.

Zeigt an, dass die Umleitung nicht permanent ist. Das Caching ist weniger aggressiv als bei 301. Verwenden Sie es für Dinge wie 'Anmeldung erforderlich, Umleitung zu /login'.

RFC 9110 ↗
303

Siehe andere Ressource

Umleitung zu einer anderen URL mit GET.

Wird nach POST-Einreichungen verwendet — die Antwort sagt 'Ihr POST hat funktioniert, rufen Sie diese GET-URL für das Ergebnis ab'. Browser rufen die neue URL immer per GET ab.

RFC 9110 ↗
304

Nicht geändert

Die zwischengespeicherte Version ist noch gültig; verwenden Sie sie.

Antwort auf eine bedingte Anfrage (mit If-None-Match- oder If-Modified-Since-Headern). Spart Bandbreite — kein Text wird zurückgegeben.

RFC 9110 ↗
307

Temporäre Umleitung

Wie 302, aber behält die ursprüngliche HTTP-Methode bei.

Wenn das Original POST war, verwendet die Umleitung ebenfalls POST. Moderne Alternative zu 302, wenn die Methodenbeibehaltung wichtig ist.

RFC 9110 ↗
308

Permanente Umleitung

Wie 301, aber behält die ursprüngliche HTTP-Methode bei.

Moderne Ersetzung für 301, wenn Sie möchten, dass POST-Anfragen nach der Umleitung POST bleiben.

RFC 9110 ↗
400

Ungültige Anfrage

Der Server konnte die Anfrage wegen fehlerhafter Syntax nicht verstehen.

Häufige Ursachen: fehlerhaftes JSON im Text, ungültige Abfrageparameter oder fehlende erforderliche Felder. Überprüfen Sie den Anfrage-Text und die Header.

RFC 9110 ↗
401

Nicht authentifiziert

Authentifizierung ist erforderlich und wurde nicht bereitgestellt.

Der Client muss Authentifizierungsanmeldedaten enthalten (Authorization-Header, Cookie, Token). 'Unauthorized' ist eine Fehlbezeichnung — es bedeutet wirklich 'unauthentifiziert'.

RFC 9110 ↗
402

Bezahlung erforderlich

Reserviert für zukünftige Verwendung — manchmal für bezahlte API-Stufen verwendet.

Ursprünglich für digitale Zahlungen bestimmt. Moderne Verwendung: APIs geben manchmal 402 zurück, wenn ein Benutzer sein bezahltes Kontingent überschritten hat.

RFC 9110 ↗
403

Verboten

Der Client ist authentifiziert, hat aber keine Berechtigung.

Unterscheidet sich von 401 — der Benutzer IST angemeldet, aber sein Konto hat keine Berechtigung für diese Ressource. Überprüfen Sie die Rollen-/Berechtigungslogik.

RFC 9110 ↗
404

Nicht gefunden

Die angeforderte Ressource existiert nicht.

Entweder ist die URL falsch, die Ressource wurde gelöscht oder sie existierte nie. Server geben manchmal 404 zurück, um zu verbergen, dass 403 genauer wäre.

RFC 9110 ↗
405

Methode nicht erlaubt

Die verwendete HTTP-Methode ist für diese Ressource nicht zulässig.

Zum Beispiel eine GET-Anfrage an einen Endpoint, der nur POST akzeptiert. Die Antwort sollte einen Allow-Header enthalten, der gültige Methoden auflistet.

RFC 9110 ↗
406

Nicht akzeptabel

Keine Darstellung entspricht den Accept-Headern des Clients.

Der Client forderte einen Inhaltstyp, eine Sprache oder eine Codierung an (über Accept, Accept-Language, Accept-Encoding), die der Server nicht erfüllen kann. Viele Server überspringen strenge Verhandlungen und geben stattdessen einen Standard zurück.

RFC 9110 ↗
407

Proxy-Authentifizierung erforderlich

Der Client muss sich zuerst beim Proxy authentifizieren.

Wie 401, aber von einem Proxy ausgegeben: der Client muss Proxy-Authorization-Anmeldedaten senden. Wird in Unternehmens-Netzwerken mit authentifizierenden Proxys angezeigt.

RFC 9110 ↗
408

Anfrage-Timeout

Zeitüberschreitung des Servers beim Warten auf die Anfrage.

Der Client hat zu lange gebraucht, um den Anforderungstext zu senden, oder die Verbindung untätig gehalten. Versuchen Sie die Anfrage erneut.

RFC 9110 ↗
409

Konflikt

Die Anfrage steht in Konflikt mit dem aktuellen Zustand der Ressource.

Wird in der Regel für Bearbeitungskonflikte oder doppelte Ressourcenerstellung zurückgegeben (z. B. Erstellen eines Benutzers mit einer E-Mail, die bereits existiert).

RFC 9110 ↗
410

Nicht mehr vorhanden

Die Ressource wurde gelöscht und kommt nicht zurück.

Stärker als 404 — der Server weiß ausdrücklich, dass die Ressource früher existierte, aber dauerhaft entfernt wurde. Suchmaschinen entfernen die Seite aus dem Index.

RFC 9110 ↗
411

Länge erforderlich

Der Server erfordert einen Content-Length-Header.

Die Anfrage wurde abgelehnt, da ein Content-Length-Header fehlte und der Server Texte unbekannter Größe ablehnt. Fügen Sie den Header hinzu und versuchen Sie es erneut.

RFC 9110 ↗
412

Vorbedingung fehlgeschlagen

Eine Bedingung in den Anfrage-Headern wurde nicht erfüllt.

Wird zurückgegeben, wenn bedingte Header wie If-Match oder If-Unmodified-Since fehlschlagen — typischerweise optimistisches Sperren: jemand anderes hat die Ressource seit Ihrer Version geändert. Rufen Sie ab und versuchen Sie es erneut.

RFC 9110 ↗
413

Nutzdaten zu groß

Der Anforderungstext überschreitet die Größenlimitierung des Servers.

Häufig beim Hochladen großer Dateien. Die Serverkonfiguration (nginx, apache) legt eine maximale Textgröße fest. Überprüfen Sie die Serverkonfiguration.

RFC 9110 ↗
414

URI zu lang

Die Anfrage-URL überschreitet die Längenlimitierung des Servers.

Normalerweise durch sehr lange Abfrage-Strings verursacht (z. B. Kodierung von Daten in einem GET). Wechseln Sie zu einem POST-Text oder erhöhen Sie das Serverlimit, wenn Sie es kontrollieren.

RFC 9110 ↗
415

Nicht unterstützter Medientyp

Der Server kann den gesendeten Content-Type nicht verarbeiten.

Zum Beispiel, application/xml an einen Server senden, der nur application/json akzeptiert. Setzen Sie den Content-Type-Header korrekt.

RFC 9110 ↗
416

Bereichsanfrage nicht erfüllbar

Der angeforderte Bytebereich befindet sich außerhalb der Ressourcengröße.

Der Range-Header fordert einen Teil an, den die Datei nicht hat — z. B. einen Download nach dem Ende der Datei fortsetzen. Die Antwort sollte Content-Range mit der tatsächlichen Größe enthalten.

RFC 9110 ↗
417

Erwartung fehlgeschlagen

Der Server kann die Anforderungen des Expect-Headers nicht erfüllen.

Wird gesendet, wenn der Server Expect: 100-continue nicht unterstützt. Einige Clients senden diesen Header standardmäßig bei großen POSTs; die Deaktivierung löst normalerweise den Fehler.

RFC 9110 ↗
418

Ich bin eine Teekanne

Der Server weigert sich, Kaffee zu brühen, weil er eine Teekanne ist.

Ein Aprilscherz von 1998 (RFC 2324). Einige echte APIs verwenden es für Witze oder um veraltete Endpunkte zu markieren. Nicht für den Produktionseinsatz.

RFC 2324 ↗
421

Falsch adressierte Anfrage

Die Anfrage wurde an einen Server gesendet, der keine Antwort darauf erzeugen kann.

Häufig bei HTTP/2-Verbindungswiederverwendung: die Anfrage erreichte einen Server, der nicht für den Zielhostnamen konfiguriert ist. Der Client sollte über eine neue Verbindung erneut versuchen.

RFC 9110 ↗
422

Nicht verarbeitbare Inhalte

Die Anfrage war syntaktisch gültig, aber semantisch falsch.

Zum Beispiel wurde JSON korrekt analysiert, aber ein erforderliches Feld fehlte oder ein Feldwert war außerhalb des Bereichs. Üblich in REST-API-Validierungsantworten.

RFC 9110 ↗
423

Gesperrt

Die Ressource ist gesperrt.

WebDAV: die Quell- oder Zielressource ist von einem anderen Client gesperrt, daher kann die Operation nicht fortgesetzt werden. Warten Sie, bis die Sperre freigegeben wird, oder brechen Sie sie mit dem richtigen Token.

RFC 4918 ↗
424

Abhängigkeit fehlgeschlagen

Die Anfrage ist fehlgeschlagen, da eine frühere abhängige Anfrage fehlgeschlagen ist.

WebDAV: in einer Kette abhängiger Operationen ist eine frühere Aktion fehlgeschlagen, daher wurde diese nicht ausgeführt. Schauen Sie sich den früheren Fehler für die Grundursache an.

RFC 4918 ↗
425

Zu früh

Der Server weigert sich, eine Anfrage zu verarbeiten, die möglicherweise wiedergegeben wird.

Bezieht sich auf TLS 1.3 0-RTT (frühe Daten): der Server wird es nicht riskieren, eine möglicherweise wiedergegebene Anfrage zu verarbeiten. Der Client sollte erneut versuchen, nachdem der Handshake abgeschlossen ist.

RFC 8470 ↗
426

Upgrade erforderlich

Der Client muss zu einem anderen Protokoll wechseln.

Der Server weigert sich, die Anfrage über das aktuelle Protokoll bereitzustellen, wird dies aber nach einem Upgrade tun — die Antwort enthält einen Upgrade-Header, der das erforderliche Protokoll benennt.

RFC 9110 ↗
428

Vorbedingung erforderlich

Der Server erfordert, dass die Anfrage bedingt ist.

Der Server verlangt bedingte Header (wie If-Match), um Lost-Update-Konflikte zu verhindern. Rufen Sie die Ressource ab, erfassen Sie ihren ETag und senden Sie ihn mit If-Match erneut.

RFC 6585 ↗
429

Zu viele Anfragen

Der Client wird begrenzt.

Bitte langsamer. Die Antwort sollte einen Retry-After-Header enthalten, der angibt, wann erneut versucht werden soll. Üblich bei APIs mit Anfragequoten.

RFC 6585 ↗
431

Anfrage-Header-Felder zu groß

Header sind zu groß, um vom Server verarbeitet zu werden.

Entweder ein Header oder die Gesamtheadergröße überschreitet das Limit — am häufigsten durch übergroße Cookies verursacht. Löschen Sie Cookies oder reduzieren Sie, was Ihre App in ihnen speichert.

RFC 6585 ↗
451

Aus rechtlichen Gründen nicht verfügbar

Zugriff aufgrund von rechtlichen Anforderungen verweigert.

Die Ressource ist aus rechtlichen Gründen blockiert — Zensur, Gerichtsbeschlüsse oder regionale Vorschriften. Die Nummer ist eine Anspielung auf den Roman Fahrenheit 451.

RFC 7725 ↗
500

Interner Serverfehler

Der Server ist auf einen unerwarteten Zustand gestoßen.

Ein allgemeiner Auffangcode für serverseitige Fehler. Überprüfen Sie die Serverprotokolle auf die eigentliche Ursache: nicht behandelte Ausnahme, Datenbankfehler usw.

RFC 9110 ↗
501

Nicht implementiert

Der Server unterstützt die angeforderte Funktionalität nicht.

Zum Beispiel erkennt der Server die HTTP-Methode nicht. Selten in der Praxis — häufiger sehen Sie 405.

RFC 9110 ↗
502

Ungültiges Gateway

Der Server erhielt als Gateway eine ungültige Antwort von einem Upstream-Server.

Häufig in Microservice-Architekturen. Ihr Load Balancer oder Reverse Proxy erhielt eine fehlgeformte Antwort vom Backend-Service.

RFC 9110 ↗
503

Service nicht verfügbar

Der Server kann die Anfrage vorübergehend nicht verarbeiten.

Entweder ist er zur Wartung offline oder überlastet. Die Antwort sollte einen Retry-After-Header enthalten. Oft während Bereitstellungen zurückgegeben.

RFC 9110 ↗
504

Gateway-Timeout

Der Gateway-Server ist beim Warten auf eine Upstream-Antwort abgelaufen.

Der Backend-Service antwortete nicht schnell genug. Überprüfen Sie die Upstream-Service-Integrität und Timeout-Konfigurationen.

RFC 9110 ↗
505

HTTP-Version nicht unterstützt

Der Server unterstützt die HTTP-Version, die in der Anfrage verwendet wird, nicht.

Die HTTP-Hauptversion der Anfrage wird vom Server nicht unterstützt. Wird mit modernen Clients fast nie angezeigt.

RFC 9110 ↗
506

Variante verhandelt auch

Der Server hat einen Inhaltsaushandlungskonfigurationsfehler.

Die transparente Inhaltsaushandlung endete in einer Schleife: Die gewählte Variante ist selbst für die Aushandlung konfiguriert. Zeigt einen Serverkonfigurationsfehler an.

RFC 2295 ↗
507

Unzureichender Speicherplatz

Der Server hat keinen Speicherplatz mehr.

Ursprünglich WebDAV-spezifisch, aber manchmal von allgemeinen Servern verwendet. Bedeutet, dass der Server die Anfrage aufgrund von Speicherbeschränkungen nicht speichern kann.

RFC 4918 ↗
508

Schleife erkannt

Der Server hat eine Endlosschleife bei der Verarbeitung der Anfrage erkannt.

WebDAV: Die Verarbeitung einer Depth: infinity-Anfrage geriet in eine Schleife (z. B. zirkuläre Bindungen). Die Operation wurde abgebrochen.

RFC 5842 ↗
510

Nicht erweitert

Weitere Erweiterungen der Anfrage sind erforderlich.

Aus dem veralteten HTTP-Extension-Framework: der Server benötigt weitere Informationen, bevor er die Anfrage erfüllen kann. Im modernen Web praktisch nicht im Einsatz.

RFC 2774 ↗
511

Netzwerkauthentifizierung erforderlich

Der Client muss sich authentifizieren, um Netzwerkzugriff zu erhalten.

Wird von Captive Portals (Hotel/Flughafen WiFi) verwendet, um anzuzeigen, dass sich der Benutzer im Netzwerk anmelden muss, bevor er auf externe Websites zugreift.

RFC 6585 ↗

Häufige Anwendungen

  • Referenz für API-DesignWählen Sie bei der Gestaltung von REST-APIs den richtigen Statuscode für jede Antwort.
  • Fehler-Codes schnell nachschlagenWenn Ihre App einen verwirrenden HTTP-Fehler zurückgibt, schlagen Sie nach, was er tatsächlich bedeutet.
  • Erfahren Sie mehr über HTTP-StatuscodesUmfassende Referenz für Studenten und Entwickler, die HTTP und REST lernen.
  • Schnelle Referenz während IncidentsWährend Produktionsincidenten schnell nachschlagen, was jeder Statuscode bedeutet.
  • Referenz für API-DokumentationVerlinken Sie beim Schreiben von API-Dokumentation auf maßgebliche Beschreibungen der Statuscodes, die Sie zurückgeben.

So funktioniert es

Dieses Tool ist eine clientseitige Referenz auf Basis einer fest hinterlegten Tabelle mit 63 HTTP-Statuscodes aus allen fünf Klassen (1xx–5xx), jeweils mit der definierenden RFC-Nummer versehen. Kein Serveraufruf, keine externe API und keine Netzwerkanfrage – das gesamte Filtern und Anzeigen erfolgt im Browser mit den integrierten Array- und String-Methoden von JavaScript.

  1. 1
    Die Nachschlagetabelle wird geladen
    Der vollständige Satz von 63 bei der IANA registrierten Statuscodes ist als JavaScript-Array direkt in dieses Tool eingebettet; jeder Eintrag enthält den numerischen Code, den kanonischen englischen Namen, die Kategorie und den definierenden RFC (z. B. RFC 9110 für die meisten HTTP/1.1-Codes, RFC 6585 für 429 Too Many Requests, RFC 2324 für 418 I'm a Teapot).
  2. 2
    Der Filter läuft im Speicher
    Während Sie tippen oder einen Kategoriefilter wählen, läuft Array.filter von JavaScript über die Liste im Speicher und gleicht Ihre Suche mit String.includes mit Statuscode, kanonischem Namen sowie kurzer und langer Beschreibung ab – ohne Entprellverzögerung, ohne Serverumweg.
  3. 3
    Details klappen mit RFC-Link auf
    Jedes Ergebnis wird als HTML-details/summary-Element dargestellt. Beim Aufklappen erscheinen die ausführliche Erklärung und ein direkter Link zum maßgeblichen RFC auf rfc-editor.org, sodass Sie den genauen Spezifikationstext zu jedem Code lesen können.
  4. 4
    Direktlinks und Kopieren in die Zwischenablage
    Das Öffnen eines Eintrags setzt den URL-Hash auf die Codenummer (z. B. #404), sodass die Seite teilbar und lesezeichenfreundlich ist. Die Kopieren-Schaltfläche schreibt die kanonische Zeichenkette (z. B. '404 Not Found') über die navigator.clipboard-API des Browsers in die Zwischenablage.

Ähnliche Tools

Häufige Fragen