Elke ontwikkelaar houdt een mentale shortlist bij van HTTP status codes Vroeger waren de mijne 200, 404, en 500, en dat was lange tijd genoeg om competentie te faken Daarna heb ik een week besteed aan het bouwen van een betalingsintegratie waarbij de API 402 teruggaf voor een geweigerde kaart, 409 toen ik een lading die al was doorgekomen opnieuw probeerde, en 429 toen mijn tests het te snel hamerden Plotseling was het verschil tussen codes het verschil tussen een werkende functie en een support ticket Ik bouw veel webtooling voor Toolz.dev, en een doorzoekbare statuscodereferentie is een van die dingen waar ik voortdurend naar reik, dus heb ik er een in de site ingebouwd en deze handleiding geschreven.
tl;dr: Een HTTP status code is een driecijferig nummer dat een server terugstuurt om het resultaat van een verzoek te beschrijven Het eerste cijfer stelt de klasse in: 1xx informatief, 2xx succes, 3xx omleiding, 4xx client fout, 5xx server fout Zoek een van hen direct op met de HTTP Status Codes tool, waarmee u kunt zoeken op nummer, naam of trefwoord en de RFC citeert die elk van deze definieert.
Deze gids gaat door wat statuscodes zijn, wat elke klasse betekent, de specifieke codes die de moeite waard zijn om te onthouden, en de codes die mensen het vaakst mis hebben. Het is bedoeld voor front-end ontwikkelaars die API-aanroepen debuggen, back-end ontwikkelaars die beslissen wat ze terugsturen en iedereen die technische SEO doet en omleidingen nodig heeft om zich te gedragen.
Wat is een HTTP status code?
Elke keer dat uw browser of een app iets opvraagt via het web, antwoordt de server met een reactie De eerste regel van dat antwoord bevat een statuscode: een driecijferig nummer, gekoppeld aan een korte redenzin als "OK" of "Not Found" De code is de machinaal leesbare samenvatting van wat er is gebeurd, en de redenzin is het mensvriendelijke label. Op het nummer handelen clients; de zin is voor mensen die logboeken lezen.
Statuscodes worden gedefinieerd door de Internet Engineering Task Force, voornamelijk in RFC 9110, die de oudere HTTP-specificaties in 2022 consolideerde. Een centraal register dat wordt onderhouden door IANA vermeldt elke officieel erkende code. Die standaardisatie is wat een door het ene bedrijf geschreven browser laat praten met een server die door een ander is geschreven en het eens wordt over wat een 404 betekent. De HTTP Status Codes tool spiegels die register, met vermelding van elke standaardcode met zijn betekenis en de RFC die deze definieert.
Het belangrijkste mentale model is dat het eerste cijfer je de categorie vertelt, en de categorie je vertelt wie verantwoordelijk is Een 4xx-code betekent dat de client iets verkeerd heeft verzonden Een 5xx-code betekent dat de server faalde op een verzoek dat prima was Dat ene onderscheid lost de meeste foutopsporingsargumenten op over wiens bug het is.
Wat betekenen de vijf statuscodeklassen?
Er zijn precies vijf klassen, gegroepeerd op het leidende cijfer. Het begrijpen van de klasse is waardevoller dan het onthouden van individuele codes, omdat het je vertelt waar je moet zoeken.
De 1xx-klasse is informatief Deze codes geven aan dat de server het verzoek heeft ontvangen en de verwerking gaat door Ze zijn zeldzaam in het dagelijkse werk De bekendste is 100 Doorgaan, en de meest bruikbare moderne is 103 Early Hints, waarmee een server de browser kan vertellen om te beginnen met het vooraf laden van bronnen voordat het volledige antwoord klaar is.
De 2xx-klasse betekent succes Het verzoek is ontvangen, begrepen en geaccepteerd. 200 OK is de dagelijkse succescode, 201 Gemaakt bevestigt dat er een nieuwe bron is gemaakt en 204 Geen inhoud zegt & quot; gedaan, niets om terug te sturen", wat gebruikelijk is voor verwijderbewerkingen.
De 3xx-klasse is redirection De resource leeft ergens anders, of is niet veranderd sinds de client het voor het laatst zag Deze klasse is waar SEO woont, want 301 en 302 vertellen zoekmachines of een zet permanent is.304 Not Modified is een caching werkpaard dat enorme bandbreedte bespaart.
De 4xx-klasse is een clientfout Het verzoek is verkeerd ingedeeld, ongeautoriseerd of gericht op iets dat niet bestaat. 400, 401, 403, 404 en 429 leven hier allemaal. Als u een 4xx ziet, controleer dan wat uw code heeft verzonden voordat u de server de schuld geeft.
De 5xx-klasse is een serverfout. Het verzoek was geldig, maar de server kon er niet aan voldoen. 500, 502, 503 en 504 zijn degenen die u tegenkomt bij productie-incidenten, meestal wijzend op een crash, een overbelaste service of een verbroken upstream-afhankelijkheid.
Welke HTTP statuscodes moet elke ontwikkelaar weten?
Je hebt niet alle zestig-plus codes in je hoofd nodig Je hebt er misschien vijftien nodig, en de rest zoek je op Hier is de werkset die volgens mij een vaste plek in het geheugen verdient, met de situaties die ze triggeren.
| Code | veelbetekenend | Als je het ziet |
|---|---|---|
| 200 | OK | Een normaal succesvol verzoek |
| 201 | Gemaakt | Een POST of PUT heeft een nieuwe bron gemaakt |
| 204 | Geen inhoud | Succes met een leeg lichaam, gebruikelijk na VERWIJDEREN |
| 301 | Permanent verplaatst | Een URL voorgoed verplaatst; SEO ranking transfers |
| 302 | Gevonden | Een tijdelijke omleiding; blijf de oude URL gebruiken |
| 304 | Not Modified | In de cache opgeslagen kopie is nog steeds geldig; geen lichaam verzonden |
| 400 | Bad Request | Misvormde syntaxis of ongeldige verzoekframing |
| 401 | Ongeautoriseerd | Authenticatie ontbreekt of is mislukt |
| 403 | Verboden | Geauthenticeerd maar niet toegestaan |
| 404 | Niet gevonden | De hulpbron bestaat niet |
| 409 | Conflict | Het verzoek botst met de huidige staat |
| 422 | Onverwerkbare inhoud | Geldige syntaxis, mislukte validatieregels |
| 429 | Te veel verzoeken | Tarief beperkt; terug uit en opnieuw proberen |
| 500 | Interne serverfout | Onverwachte serverfout |
| 503 | Service niet beschikbaar | Server overbelast of in onderhoud |
De rest van het register, van 226 IM Used tot 451 Unavailable For Legal Reasons, is het waard om te herkennen maar niet te onthouden. Dat is precies waar een opzoektool voor is.
Wat is het verschil tussen 401 en 403?
Dit paar struikelt bijna iedereen, dus het verdient een eigen sectie Beide betekenen dat de toegang werd geweigerd, maar om verschillende redenen, en het verschil verandert hoe uw app zou moeten reageren.
Een 401 Ongeautoriseerd betekent dat het verzoek geen geldige authenticatie heeft De server weet niet wie je bent Ofwel heb je geen inloggegevens verzonden, ofwel waren de door jou verzonden inloggegevens verkeerd of verlopen Het juiste antwoord van jouw kant is om in te loggen of het token te vernieuwen. Volgens de specificaties moet een 401-antwoord een WWW-Authenticate-header bevatten die de client vertelt hoe hij zich moet authenticeren.
Een 403 Verboden betekent dat de server precies weet wie je bent en toch weigert Je bent geauthenticeerd maar niet geautoriseerd voor deze specifieke bron Inloggen helpt niet, omdat het probleem machtigingen is, geen identiteit Een gewone gebruiker die een admin-only eindpunt raakt, moet een 403 krijgen.
De snelle regel die ik gebruik: 401 is & quot; wie ben jij?", 403 is " Ik weet wie je bent, en no" Als u een API bouwt en de Authorization-headers wilt genereren om deze stromen te testen, zal de Basic Auth Generator produceert de gecodeerde inloggegevens die u nodig heeft.
Waarom zijn 301 versus 302 omleidingen belangrijk voor SEO?
Omleidingen zijn waar statuscodes niet langer een intern implementatiedetail zijn en uw zoekranglijst beginnen te beïnvloeden. Wanneer u een pagina verplaatst, vertelt de statuscode die u retourneert zoekmachines wat ze moeten doen met de oude URL's geaccumuleerde autoriteit.
Een 301 Moved Permanent signaleert dat de verhuizing definitief is Zoekmachines laten de oude URL in de loop van de tijd uit hun index vallen, geven de rankingsignalen door aan de nieuwe URL en werken hun links bij Dit is de gewenste code wanneer u een pagina hernoemt, migreert naar HTTPS of dubbele URL's consolideert. Het correct gebruiken ervan is een van de meest voorkomende oplossingen in een technische SEO-audit.
Een 302 Found signaleert een tijdelijke verhuizing Zoekmachines houden de originele URL geïndexeerd omdat je ze hebt verteld dat de wijziging niet permanent is Als je een 302 gebruikt voor een zet die permanent is, kun je je ranking laten stranden op een URL die je niet meer gebruikt Ik heb sites maandenlang zicht zien verliezen omdat een framework standaard naar 302 omleidingen ging tijdens een HTTPS-migratie.
Er zijn ook 307 tijdelijke omleidingen en 308 permanente omleidingen, die zich gedragen als 302 en 301 maar garanderen dat de HTTP-methode en - body behouden blijven Gebruik 307 en 308 voor niet-GET-verzoeken waarbij het wijzigen van de methode dingen zou breken Als u controleert hoe crawlers uw site zien, koppelt u deze kennis aan de Robots.txt-generator en de Meta-tag-generator om er zeker van te zijn dat het hele crawl- en omleidingsbeeld consistent is. De Webontwikkelaar Toolkit gids bindt deze stukken aan elkaar.
Wat zijn de meest voorkomende serverfoutcodes en hoe debug je deze?
De 5xx-klasse is waar productie-incidenten leven, en elke code wijst je op een andere laag van de stapel Weten welke is die real-time bespaart tijdens een storing.
Een 500 Internal Server Error is de generieke catch-all Het betekent dat uw applicatiecode een niet-afgehandelde uitzondering heeft gegooid of een voorwaarde heeft getroffen die het niet kon verwerken De oplossing staat bijna altijd in uw eigen logboeken Een 500 is de server die zegt & quot; er is iets kapot en ik heb er geen beter woord voor en quot;, dus de code vertelt je waar je moet zoeken, maar niet wat er mis is gegaan.
Een 502 Bad Gateway en een 504 Gateway Timeout zijn beide afkomstig van een server die als gateway of proxy fungeert, zoals een load balancer of een reverse proxy voor je app Een 502 betekent dat de upstream iets ongeldigs terugstuurde, vaak omdat je applicatie crashte of niet draait Een 504 betekent dat de upstream te lang nodig had om te reageren en de gateway het wachten opgaf Als je achter Nginx, een CDN of een cloud load balancer loopt, zijn dit de codes die je ziet als het ding achter de proxy ongezond is.
Een 503 Service Unavailable betekent dat de server tijdelijk niet in staat is om het verzoek af te handelen, meestal omdat het overbelast is of in onderhoud is Goed gedragen 503 reacties bevatten een Retry-After header die clients vertelt wanneer ze terug moeten komen Het verzenden van een 503 tijdens gepland onderhoud is de juiste, SEO-veilige manier om een site kort uit te schakelen, omdat het zoekmachines vertelt later terug te komen in plaats van aan te nemen dat de pagina's verdwenen zijn Voor een bredere blik op het diagnosticeren van webproblemen, de Productiviteitstools voor ontwikkelaar gids behandelt de bredere toolkit.
Hoe zit het met de minder gebruikelijke statuscodes?
Naast de werkset bevat het register een lange reeks codes die u af en toe zult ontmoeten, en het herkennen ervan bespaart een verward half uur. Een paar zijn een snelle rondleiding waard.
In de 2xx-familie zorgt 206 Partial Content voor resumeerbare downloads en videostreaming Wanneer een client een Range-header verzendt waarin om bytes 500 tot 999 van een bestand wordt gevraagd, antwoordt de server 206 met precies dat segment. Dit is hoe een gepauzeerde download wordt hervat in plaats van opnieuw te beginnen, en hoe een browser naar het midden van een video zoekt zonder eerst het hele ding op te halen.
In de 4xx-familie is 410 Gone een sterkere, meer bewuste versie van 404. Waar 404 zegt & quot; Ik kon het niet vinden", 410 zegt & quot; het was hier, het is permanent weg, stop met vragen" Met behulp van 410 voor inhoud die u opzettelijk hebt verwijderd, kunnen zoekmachines deze sneller laten vallen dan een 404. Een andere nuttige is 451 Unavailable For Legal Reasons, wiens nummer een knipoog is naar de roman Fahrenheit 451, geretourneerd wanneer inhoud wordt geblokkeerd door een juridisch bevel zoals een verwijdering of een gerechtelijk bevel.
Er is ook 418 I & #39; m a Teapot, een echte geregistreerde code uit een April Fools specificatie uit 1998 dat een theepot terugkeert wanneer gevraagd wordt om koffie te zetten Het wordt niet gebruikt voor normaal verkeer, maar het verschijnt als een easter egg in sommige API's, en het is een kleine herinnering dat de mensen die deze standaarden schreven gevoel voor humor hadden De tool somt deze allemaal op, zodat je alles kunt opzoeken wat je tegenkomt zonder te raden.
Hoe helpt de tool HTTP Status Codes?
De tool is bewust eenvoudig, omdat de taak eenvoudig is: u hebt een code of een symptoom, en u wilt de betekenis snel U kunt zoeken op het nummer, op de redenzin als "not found", of op een trefwoord uit de beschrijving als " redirect" of "rate limit" U kunt naar een enkele klasse filteren om alleen door de omleidingen of alleen door de serverfouten te bladeren Elke invoer toont de redenzin, een duidelijke uitleg van wanneer de code van toepassing is en de RFC die deze definieert, zodat u gedrag kunt bevestigen aan de hand van de primaire bron.
Omdat het hele register in uw browser wordt geladen, is zoeken direct en werkt offline zodra de pagina is geopend Niets dat u zoekt wordt ergens verzonden Het is het soort referentie dat ik op een tabblad houd vastgepind tijdens het bouwen van een API, direct naast de User Agent Parser voor het inspecteren van verzoekkoppen.
Veelgestelde vragen
Wat zijn de vijf klassen van HTTP-statuscodes?
HTTP-statuscodes zijn gegroepeerd op basis van hun eerste cijfer: 1xx informatief, 2xx succes, 3xx omleiding, 4xx clientfout en 5xx serverfout De klasse vertelt u in één oogopslag of een verzoek is geslaagd, omgeleid of mislukt aan de client- of serverzijde, wat meestal voldoende is om te weten waar u kunt beginnen met debuggen.
Wat betekent een 404 statuscode?
Een 404 Not Found betekent dat de server de gevraagde bron niet kon vinden De URL kan verkeerd gespeld zijn, de pagina kan verwijderd zijn, of de link kan verbroken zijn Het is een client-error code, dus het verzoek bereikte de server maar wees naar iets dat daar niet bestaat.
Wat is het verschil tussen een 301 en een 302-omleiding?
Een 301 Moved Permanently vertelt clients en zoekmachines dat de bron voorgoed is verplaatst, dus werken ze hun links bij en dragen ze rankingsignalen over naar de nieuwe URL. Een 302 Found is een tijdelijke omleiding, dus de originele URL moet gebruikt blijven worden voor toekomstige verzoeken en zoekmachines houden deze geïndexeerd.
Wat betekent een 500 Internal Server Error?
Een 500 Internal Server Error is een generiek bericht dat betekent dat de server een onverwachte toestand heeft bereikt die hij niet aankon. Het signaleert een probleem op de server in plaats van op het verzoek, dus de oplossing bevindt zich meestal in de applicatiecode of configuratie, en uw eigen serverlogboeken zijn de plek om te kijken.
Wanneer moet een API 400 versus 422 retourneren?
Retourneer 400 Slecht verzoek wanneer het verzoek zelf verkeerd is ingedeeld, zoals ongeldige JSON of een ontbrekende vereiste header Retourneer 422 Onverwerkbare inhoud wanneer de syntaxis geldig is, maar de gegevens niet voldoen aan de bedrijfs- of validatieregels, zoals een e-mail die al is afgenomen of een waarde buiten bereik.
Wat is een 429 Too Many Requests code?
Een 429 Too Many Requests betekent dat de klant in korte tijd te veel verzoeken heeft verzonden en een tariefbeperking heeft. Het antwoord bevat vaak een Retry-After-header waarin de klant wordt verteld hoe lang hij moet wachten voordat hij het opnieuw probeert, en goed opgevoede klanten eren het met een exponentiële back-off.
Is de HTTP-statuscodereferentie gratis te gebruiken?
Ja. de tool is volledig gratis zonder aanmelding en zonder limieten, en het werkt offline zodra de pagina is geladen omdat de hele lijst in uw browser draait Niets dat u zoekt wordt naar een server verzonden, dus het is veilig en snel te gebruiken tijdens het debuggen.
