Die HTTP-Statuscodes-Referenz ist eine lokale Nachschlagetabelle, kein Werkzeug für Anfragen: Alle 62 Zeilen sitzen im Bundle der Seite, jede verbindet eine dreistellige Zahl mit einem farbigen Badge, einem Namen und einer Zeile Beschreibung, und sowohl die Suchbox als auch die fünf Klassen-Buttons filtern diese Tabelle im Browser ohne jeden Netzwerkertrag, sodass Sie die HTTP-Statuscodes-Referenz öffnen und tippen können, bevor etwas Ihre Maschine verlässt.
Die 62 Zeilen und ihre fünf Klassen
Die Tabelle gruppiert die 62 Zeilen in fünf Klassen mit 4, 10, 8, 29 und 11 Zeilen: Informational (blaue Badges), Success (grün), Redirection (gelb), Client Error (orange) und Server Error (rot). Jede Zeile druckt den Code, den lokalisierten Namen, das Klassenetikett und eine Zeile Beschreibung, und die Namen und Beschreibungen sind in alle sieben Sprachen der Seite übersetzt, sodass dieselbe Zeile in jeder Sprache die eigene Fassung liest. Was die Zeile beschreibt, ist die Statuszeile, nicht die Nutzlast: Wenn eine 2xx-Antwort einen JSON-Body mitbringt, ist der JSON Formatter der Ort, an dem diese Nutzlast inspiziert wird.
Wie die Suchbox trifft
Die Suche macht einen Teilzeichenkettenabgleich ohne Groß-Kleinschreibung über drei Felder zugleich: den Code als Ziffern, den Namen und die Beschreibung. 40 einzutippen liefert genau die zehn Zeilen, die mit 40 beginnen, weil kein anderer Code der Tabelle dieses Ziffernpaar trägt; gateway einzutippen liefert genau zwei Zeilen, 502 Bad Gateway und 504 Gateway Timeout, beide über den Namen; und 404 einzutippen reduziert die ganze Tabelle auf eine einzige Zeile. Der Beschreibungstext zählt auch, womit eine Suche eine Zeile über Wörter treffen kann, die in ihrem Namen nie auftauchen.
Wie sich der Klassenfilter mit der Suche kombiniert
Die fünf Klassen-Buttons wirken als zweite Bedingung neben der Suchbox: eine Zeile muss beide erfüllen, um angezeigt zu werden. Auf den ausgewählten Klassen-Button zu klicken schaltet ihn wieder ab, und All setzt den Filter auf die ganze Tabelle zurück. gateway plus 4xx ergibt null Zeilen, denn beide gateway-Zeilen sind 5xx; die Seite gibt dann ihren Leerzustand "No matching status codes" aus, mit dem Zähler "Showing 0 of 62". Derselbe Zähler ist der Weg, ein Filterergebnis auf einen Blick zu lesen: webdav einzutippen trifft acht Zeilen über vier Klassen verteilt, und der Zähler bestätigt Showing 8 of 62, bevor Sie eine einzige Zeile gelesen haben.
Die Zeilen, die am häufigsten nachgeschlagen werden
Fünf Zeilen machen die meisten Nachschläge aus. 404 Not Found sagt, die Ressource fehlt; 502 Bad Gateway und 504 Gateway Timeout zeigen beide auf einen Upstream-Server, einer antwortete ungültig und einer antwortete nicht rechtzeitig; 429 Too Many Requests ist die Ratenbeschränkung, die greift; und 401 Unauthorized bedeutet, dass Authentifizierung verlangt wird. 204 No Content ist der stille Erfolg, eine angenommene Anfrage ohne etwas zurückschicken. Bei Weiterleitungen trägt die Beschreibung den praktischen Unterschied: 301 Moved Permanently sagt, die Ressource sei an eine neue URL gezogen, während 308 Permanent Redirect ergänzt, der Client müsse die Anfrage mit derselben Methode wiederholen. Und ja, die Tabelle behält 418, die Teekanne-Zeile aus der RFC 2324 Oster-Ei-Spezifikation, im orangen 4xx-Bereich.
Von der Statuszeile zum Antwortkörper
Ein Statuscode ist eine Zeile der Antwort; alles danach liegt außerhalb dieser Tabelle. Ein 200-Körper kann JSON, HTML oder Binär sein, und der Körper eines 502 ist oft eine reine Textfehlerseite des Upstream, sodass das Lesen des Codes sagt, welche Schicht fehlschlug, aber niemals, was die Nutzlast sagt. Die Referenz selbst sendet keine Anfrage, also ist das Nächste am echten Verkehr die Test-URL, die Sie dazu bauen: Wenn diese URL Wertpaare mit Leerzeichen, & oder Unicode trägt, percent-kodiert der URL Encoder sie, damit die Anfragezeile wohlgeformt ist, bevor Sie senden.
Was diese Referenz nicht ist
Sie ist kein Prüfer: Es wird keine Anfrage gestellt, keine Live-Kopfzeilen geholt und kein Serverlog ausgewertet. Sie ist eine Tischreferenz für die 62 Zeilen, der Rest ist einen Klick entfernt. Wenn ein 401 mit einem Token kommt, öffnet der JWT Decoder das Token, um zu sehen, welcher Anspruch fehlgeschlagen ist; wenn Sie Digests vergleichen, um zu entscheiden, ob sich die Nutzlast änderte, berechnet der Hash Generator beide; wenn Sie Statuscodes aus einem Zugriffslog ziehen müssen, trifft der Regex Tester das Muster zuerst. Für den Content-Type, der einen Fehler für nicht unterstützte Medienart auslöst, listet die Mime Types-Anleitung den richtigen Wert, und wenn der Fehlerkörper HTML ist, das Sie lesbar wollen, zeigt die HTML-Formatierungs-Anleitung, wie man ihn aufschönt.