Jeder Entwickler führt eine gedankliche Shortlist von HTTP-Statuscodes Meine waren früher 200, 404 und 500, und das reichte lange Zeit aus, um Kompetenz vorzutäuschen Dann habe ich eine Woche lang eine Zahlungsintegration aufgebaut, bei der die API 402 für eine abgelehnte Karte zurückgegeben hat, 409, als ich eine bereits durchgelaufene Ladung erneut ausprobiert habe, und 429, als meine Tests sie zu schnell durcheinander gebracht haben Plötzlich war der Unterschied zwischen Codes der Unterschied zwischen einer funktionierenden Funktion und einem Support-TicketIch baue eine Menge Web-Tooling für Toolz.dev„und eine durchsuchbare Statuscode-Referenz ist eines der Dinge, nach denen ich ständig greife, also habe ich eine in die Website integriert und passend dazu diese Anleitung geschrieben.
tl; dr: Ein HTTP-Statuscode ist eine dreistellige Zahl, die ein Server zurückschickt, um das Ergebnis einer Anfrage zu beschreiben Die erste Ziffer setzt die Klasse: 1xx informativ, 2xx Erfolg, 3xx-Umleitung, 4xx Client-Fehler, 5xx Server-Fehler Schauen Sie sich eines davon sofort mit dem HTTP-Statuscodes-Tool, mit dem Sie nach Nummer, Name oder Schlüsselwort suchen und den RFC zitieren können, der jeden definiert.
Dieser Leitfaden geht durch, was Statuscodes sind, was jede Klasse bedeutet, welche spezifischen Codes es wert sind, sich zu merken, und welche, die Menschen am häufigsten falsch liegen. Er richtet sich an Front-End-Entwickler, die API-Aufrufe debuggen, Back-End-Entwickler, die entscheiden, was sie zurückgeben möchten, und an alle, die technische SEO betreiben und Weiterleitungen benötigen, um sich zu verhalten.
Was ist ein HTTP-Statuscode?
Jedes Mal, wenn Ihr Browser oder eine App etwas über das Web anfordert, antwortet der Server mit einer Antwort Die erste Zeile dieser Antwort enthält einen Statuscode: eine dreistellige Zahl, gepaart mit einer kurzen Begründungsphrase wie "OK" oder "Not Found" Der Code ist die maschinenlesbare Zusammenfassung dessen, was passiert ist, und die Begründungsphrase ist die menschenfreundliche Bezeichnung. Clients handeln auf die Zahl; die Phrase ist für Leute, die Protokolle lesen.
Statuscodes werden von der Internet Engineering Task Force definiert, vor allem in RFC 9110, der die älteren HTTP-Spezifikationen im Jahr 2022 konsolidierte. Eine von der IANA geführte zentrale Registrierung listet jeden offiziell anerkannten Code auf. Diese Standardisierung ermöglicht es einem von einem Unternehmen geschriebenen Browser, mit einem von einem anderen geschriebenen Server zu sprechen und sich darüber zu einigen, was ein 404 bedeutet. Die HTTP-Statuscodes-Tool Spiegelt diese Registrierung wider und listet jeden Standardcode mit seiner Bedeutung und dem RFC auf, der ihn definiert.
Das entscheidende mentale Modell ist, dass die erste Ziffer Ihnen die Kategorie angibt, und die Kategorie Ihnen sagt, wer verantwortlich ist Ein 4 xx-Code bedeutet, dass der Client etwas falsch gesendet hat Ein 5 xx-Code bedeutet, dass der Server bei einer Anfrage, die in Ordnung war, gescheitert ist Diese einzelne Unterscheidung löst die meisten Debugging-Argumente darüber auf, um wessen Fehler es sich handelt.
Was bedeuten die fünf Statuscodeklassen?
Es gibt genau fünf Klassen, gruppiert nach der führenden Ziffer Die Klasse zu verstehen ist wertvoller als sich einzelne Codes zu merken, denn sie sagt einem, wo man suchen muss.
Die 1xx-Klasse ist informativ Diese Codes signalisieren, dass der Server die Anfrage empfangen hat und die Verarbeitung geht weiter Sie sind selten im Arbeitsalltag Am bekanntesten ist 100 Continue, und der nützlichste moderne ist 103 Early Hints, mit dem ein Server dem Browser sagen kann, er solle mit dem Vorladen von Ressourcen beginnen, bevor die vollständige Antwort fertig ist.
Die 2xx-Klasse bedeutet Erfolg Die Anfrage wurde empfangen, verstanden und angenommen.200 OK ist der alltägliche Erfolgscode, 201 Created bestätigt, dass eine neue Ressource erstellt wurde, und 204 No Content sagt " gemacht, nichts zurückzusenden" was für Löschvorgänge üblich ist.
Die 3xx-Klasse ist Umleitung Die Ressource lebt woanders, oder hat sich nicht verändert, seit der Client sie das letzte Mal gesehen hat In dieser Klasse lebt SEO, denn 301 und 302 sagen Suchmaschinen, ob ein Umzug dauerhaft ist.304 Not Modified ist ein Caching-Arbeitstier, das enorme Bandbreite spart.
Die 4xx-Klasse ist ein Client-Fehler Die Anfrage wurde fehlerhaft, nicht autorisiert oder auf etwas gerichtet, das nicht existiert. 400, 401, 403, 404 und 429 alle live hier Wenn Sie einen 4xx sehen, überprüfen Sie, was Ihr Code gesendet hat, bevor Sie dem Server die Schuld geben.
Die 5xx-Klasse ist ein Serverfehler. Die Anfrage war gültig, aber der Server konnte sie nicht erfüllen. 500, 502, 503 und 504 sind diejenigen, auf die Sie bei Produktionsvorfällen stoßen und die normalerweise auf einen Absturz, einen überlasteten Dienst oder eine defekte Upstream-Abhängigkeit hinweisen.
Welche HTTP-Statuscodes sollte jeder Entwickler kennen?
Sie brauchen nicht alle über sechzig Codes in Ihrem Kopf Sie brauchen vielleicht fünfzehn, und den Rest schauen Sie nach. Hier ist das Arbeitsset, das meiner Meinung nach einen festen Platz im Gedächtnis einnimmt, mit den Situationen, die sie auslösen.
| Code | Bedeutung | Wenn man es sieht |
|---|---|---|
| 200 | OK | Eine normale erfolgreiche Anfrage |
| 201 | Erstellt | Ein POST oder PUT hat eine neue Ressource erstellt |
| 204 | Kein Inhalt | Erfolg mit einem leeren Körper, üblich nach DELETE |
| 301 | Dauerhaft bewegt | Eine URL wurde endgültig verschoben; SEO-Ranking-Übertragungen |
| 302 | Gefunden | Eine temporäre Weiterleitung; Verwenden Sie weiterhin die alte URL |
| 304 | Nicht geändert | Zwischengespeicherte Kopie ist weiterhin gültig; keine Stelle gesendet |
| 400 | Schlechte Anfrage | Fehlgebildete Syntax oder ungültiges Request Framing |
| 401 | Unerlaubt | Authentifizierung fehlt oder ist fehlgeschlagen |
| 403 | Verboten | Authentifiziert, aber nicht erlaubt |
| 404 | Nicht gefunden | Die Ressource existiert nicht |
| 409 | Konflikt | Die Anfrage kollidiert mit dem aktuellen Stand |
| 422 | Unverarbeitbarer Inhalt | Gültige Syntax, fehlgeschlagene Validierungsregeln |
| 429 | Zu viele Anfragen | Rate begrenzt; Zurückziehen und erneut versuchen |
| 500 | Interner Serverfehler | Unerwarteter Serverausfall |
| 503 | Service Nicht verfügbar | Server überlastet oder in Wartung |
Der Rest der Registry, von 226 IM Used bis 451 Unavailable For Legal Reasons, ist es wert, erkannt, aber nicht auswendig gelernt zu werden Genau dafür ist ein Lookup-Tool da.
Was ist der Unterschied zwischen 401 und 403?
Dieses Paar stolpert fast bei jedem hoch, daher verdient es einen eigenen Abschnitt. Beides bedeutet, dass der Zugriff verweigert wurde, allerdings aus unterschiedlichen Gründen, und der Unterschied ändert, wie Ihre App reagieren sollte.
Eine 401 Unautorisiert bedeutet, dass der Anfrage eine gültige Authentifizierung fehlt Der Server weiß nicht, wer Sie sind Entweder haben Sie keine Anmeldeinformationen gesendet, oder die, die Sie gesendet haben, waren falsch oder abgelaufen Die richtige Antwort von Ihrer Seite ist, sich anzumelden oder das Token aufzufrischen Per spec sollte eine 401 Antwort einen WWW-Authenticate Header enthalten, der dem Client sagt, wie er sich authentifizieren soll.
Ein 403 Forbidden bedeutet, dass der Server genau weiß, wer du bist und sich sowieso weigert, Du bist zwar authentifiziert, aber nicht für diese spezielle Ressource autorisiert, ein erneutes Anmelden hilft nicht, denn das Problem sind Berechtigungen, nicht Identität Ein regulärer Benutzer, der einen Admin-only-Endpunkt trifft, sollte einen 403 bekommen.
Die Schnellregel, die ich verwende: 401 ist & quot; wer sind Sie?", 403 ist " Ich weiß, wer Sie sind, und no" Wenn Sie eine API erstellen und die Berechtigungsheader zum Testen dieser Flüsse generieren möchten, wird die Basic Auth Generator Erzeugt die codierten Anmeldeinformationen, die Sie benötigen.
Warum sind 301 gegenüber 302 Weiterleitungen für SEO wichtig?
Weiterleitungen sind dort, wo Statuscodes aufhören, ein internes Implementierungsdetail zu sein, und anfangen, Ihre Suchrankings zu beeinflussen Wenn Sie eine Seite verschieben, sagt der Statuscode, den Sie zurückgeben, Suchmaschinen, was mit der alten URL' s akkumulierten Autorität zu tun ist.
Ein 301 Moved Permanent signalisiert, dass der Umzug endgültig ist Suchmaschinen lassen die alte URL im Laufe der Zeit aus ihrem Index fallen, geben die Ranking-Signale an die neue URL weiter, und aktualisieren ihre Links Dies ist der Code, den Sie wollen, wenn Sie eine Seite umbenennen, auf HTTPS migrieren, oder doppelte URLs konsolidieren, die korrekte Verwendung ist eine der häufigsten Korrekturen in einem technischen SEO-Audit.
Ein 302 Found signalisiert einen temporären Umzug Suchmaschinen halten die ursprüngliche URL indiziert, da Sie ihnen gesagt haben, dass die Änderung nicht dauerhaft ist, wenn Sie einen 302 für einen Zug verwenden, der dauerhaft ist, können Sie Ihr Ranking auf einer URL festhalten, die Sie nicht mehr verwenden Ich habe seit Monaten gesehen, dass Websites die Sichtbarkeit verlieren, weil ein Framework während einer HTTPS-Migration standardmäßig auf 302 Weiterleitungen umgestellt wurde.
Es gibt auch 307 Temporary Redirect und 308 Permanent Redirect, die sich wie 302 und 301 verhalten, aber garantieren, dass die HTTP-Methode und der HTTP-Körper erhalten bleiben Verwenden Sie 307 und 308 für Nicht-GET-Anfragen, bei denen eine Änderung der Methode zu Problemen führen würde Wenn Sie prüfen, wie Crawler Ihre Website sehen, koppeln Sie dieses Wissen mit dem robots.txt-Generator und das Meta-Tag-Generator Um sicherzustellen, dass das gesamte Crawling- und Weiterleitungsbild konsistent ist. Die Webentwickler-Toolkit Führung bindet diese Teile zusammen.
Was sind die häufigsten Server-Fehlercodes und wie debuggt man sie?
In der 5xx-Klasse sind Produktionsvorfälle live, und jeder Code zeigt Sie auf eine andere Ebene des Stapels Wissen, was ist, was spart Echtzeit während eines Ausfalls.
Ein 500 Internal Server Error ist das generische Sammelsurium Es bedeutet, dass Ihr Anwendungscode eine nicht behandelte Ausnahme geworfen hat oder eine Bedingung getroffen hat, die er nicht verarbeiten konnte Der Fix befindet sich fast immer in Ihren eigenen Protokollen Ein 500 ist der Server, der " etwas kaputt gemacht hat und ich habe kein besseres Wort für ", also sagt Ihnen der Code, wo Sie suchen sollen, aber nicht, was schief gelaufen ist.
Ein 502 Bad Gateway und ein 504 Gateway Timeout stammen beide von einem Server, der als Gateway oder Proxy fungiert, wie zum Beispiel ein Load Balancer oder ein Reverse Proxy vor Ihrer App. Ein 502 bedeutet, dass der Upstream etwas Ungültiges zurückgesendet hat, oft weil Ihre Anwendung abgestürzt ist oder nicht ausgeführt wird. Ein 504 bedeutet, dass der Upstream zu lange brauchte, um zu antworten, und das Gateway das Warten aufgegeben hat Wenn Sie hinter Nginx, einem CDN oder einem Cloud Load Balancer laufen, sind dies die Codes, die Sie sehen werden, wenn das Ding hinter dem Proxy ungesund ist.
Ein 503 Service Unavailable bedeutet, dass der Server vorübergehend nicht in der Lage ist, die Anfrage zu bearbeiten, normalerweise weil er überlastet ist oder sich in der Wartung befindet. Gut benutzte 503-Antworten enthalten einen Retry-After-Header, der Clients angibt, wann sie zurückkommen sollen. Das Senden eines 503 während der geplanten Wartung ist der richtige, SEO-sichere Weg, eine Website kurz zu entfernen, da Suchmaschinen angewiesen werden, später wiederzukommen, anstatt davon auszugehen, dass die Seiten verschwunden sind. Für einen umfassenderen Blick auf die Diagnose von Webproblemen ist die Entwicklerproduktivitätstools Der Leitfaden deckt das breitere Toolkit ab.
Wie sieht es mit den weniger verbreiteten Statuscodes aus?
Über das Arbeitsset hinaus verfügt die Registrierung über eine lange Anzahl von Codes, die Sie gelegentlich treffen, und das Erkennen dieser Codes spart eine verwirrende halbe Stunde. Ein paar sind eine kurze Tour wert.
In der 2xx-Familie ermöglicht 206 Partial Content wieder absetzbare Downloads und Video-Streaming, Wenn ein Client einen Range-Header sendet, der nach Bytes 500 bis 999 einer Datei fragt, antwortet der Server 206 mit genau diesem Slice So wird ein angehaltener Download fortgesetzt, anstatt von vorne zu beginnen, und wie ein Browser in die Mitte eines Videos sucht, ohne das Ganze zuerst abzurufen.
In der 4 xx-Familie ist 410 Gone eine stärkere, bewusstere Version von 404. Wo 404 sagt & quot; Ich konnte es nicht finden", 410 sagt " es war hier, es ist dauerhaft weg, hören Sie auf zu fragen". 410 für Inhalte zu verwenden, die Sie absichtlich entfernt haben, hilft Suchmaschinen, es schneller als eine 404 fallen zu lassen. Eine andere nützliche ist 451 Unavailable For Legal Reasons, deren Nummer eine Anspielung auf die neuartige Fahrenheit 451 ist, die zurückgegeben wird, wenn Inhalte durch eine gesetzliche Anordnung wie eine Aufhebung oder eine gerichtliche Verfügung blockiert werden.
Es gibt auch 418 I' m eine Teekanne, ein echter registrierter Code aus einer Aprilscherz-Spezifikation von 1998, dass eine Teekanne zurückkehrt, wenn sie gebeten wird, Kaffee zu brauen. Sie wird nicht für den normalen Verkehr verwendet, aber sie erscheint in einigen APIs als Easter Egg, und es ist eine kleine Erinnerung daran, dass die Leute, die diese Standards geschrieben haben, einen Sinn für Humor hatten. Das Tool listet all dies auf, damit Sie alles nachschlagen können, worüber Sie stolpern, ohne zu raten.
Wie hilft das Tool HTTP Status Codes?
Das Tool ist bewusst einfach, denn die Arbeit ist einfach: Sie haben einen Code oder ein Symptom, und Sie möchten die Bedeutung schnell Sie können nach der Nummer suchen, nach der Grundphrase wie & quot; not found" oder nach einem Schlüsselwort aus der Beschreibung wie & quot; redirect" oder & quot;rate limit". Sie können in eine einzelne Klasse filtern, um nur die Weiterleitungen oder nur die Serverfehler zu durchsuchen. Jeder Eintrag zeigt den Grund, eine einfache Erklärung, wann der Code gilt, und den RFC, der ihn definiert, sodass Sie das Verhalten anhand der Primärquelle bestätigen können.
Da die gesamte Registry in Ihrem Browser geladen wird, ist die Suche sofort möglich und funktioniert offline, sobald die Seite geöffnet ist. Nichts, was Sie suchen, wird irgendwo gesendet. Es ist die Art von Referenz, die ich beim Erstellen einer API direkt neben der Registerkarte festhalte Benutzeragent Parser zur Prüfung von Anforderungsheadern.
Häufig gestellte Fragen
Was sind die fünf Klassen von HTTP-Statuscodes?
HTTP-Statuscodes werden nach ihrer ersten Ziffer gruppiert: 1 xx informational, 2 xx success, 3 xx redirection, 4 xx client error, and 5 xx server error Die Klasse sagt Ihnen auf einen Blick, ob eine Anfrage erfolgreich war, umgeleitet wurde oder auf Client - oder Serverseite fehlgeschlagen ist, was normalerweise ausreicht, um zu wissen, wo Sie mit dem Debuggen beginnen sollen.
Was bedeutet ein 404 Statuscode?
Ein 404 Not Found bedeutet, dass der Server die angeforderte Ressource nicht finden konnte Die URL kann falsch geschrieben sein, die Seite wurde möglicherweise gelöscht oder der Link ist defekt Es handelt sich um einen Client-Fehlercode, sodass die Anfrage den Server erreichte, aber auf etwas zeigte, das dort nicht existiert.
Was ist der Unterschied zwischen einer 301 und einer 302-Weiterleitung?
A 301 Moved Permanently teilt Clients und Suchmaschinen mit, dass sich die Ressource endgültig bewegt hat, sodass sie ihre Links aktualisieren und Ranking-Signale an die neue URL übertragen. A 302 Found ist eine vorübergehende Weiterleitung, daher sollte die ursprüngliche URL weiterhin für zukünftige Anfragen verwendet werden und Suchmaschinen halten sie indiziert.
Was bedeutet ein 500 Internal Server Error?
Ein 500 Internal Server Error ist eine generische Nachricht, was bedeutet, dass der Server einen unerwarteten Zustand erreicht hat, den er nicht verarbeiten konnte. Es signalisiert ein Problem auf dem Server und nicht die Anfrage, sodass der Fix normalerweise im Anwendungscode oder in der Konfiguration enthalten ist und Ihre eigenen Serverprotokolle der richtige Ort sind, um nachzusehen.
Wann sollte eine API 400 gegenüber 422 zurückgeben?
Geben Sie 400 Bad Request zurück, wenn die Anfrage selbst fehlerhaft ist, z. B. ungültiges JSON oder ein fehlender erforderlicher Header. Geben Sie 422 unverarbeitbare Inhalte zurück, wenn die Syntax gültig ist, die Daten jedoch die Geschäfts- oder Validierungsregeln nicht erfüllen, z. B. eine bereits angenommene E-Mail oder ein Wert außerhalb des Bereichs.
Was ist ein 429 Too Many Requests Code?
Eine 429 Too Many Requests bedeutet, dass der Client zu viele Anfragen in kurzer Zeit gesendet hat und die Rate begrenzt wird. Die Antwort enthält oft einen Retry-After-Header, der dem Client mitteilt, wie lange er warten muss, bevor er es erneut versucht, und brave Clients ehren dies mit einem exponentiellen Backoff.
Ist die Verwendung der HTTP-Statuscode-Referenz kostenlos?
Ja. Das Tool ist völlig kostenlos ohne Anmeldung und ohne Limits, und es funktioniert offline, sobald die Seite geladen wurde, weil die gesamte Liste in Ihrem Browser läuft Nichts, was Sie suchen, wird an einen Server gesendet, so dass es sicher und schnell zu verwenden ist, während des Debuggens.
