2xx · Geslaagd
200
OK
Het verzoek is gelukt. Wat de body bevat hangt af van de methode: de resource bij GET, het resultaat van de actie bij POST.
Wanneer je hem gebruikt: Het standaardantwoord op een verzoek dat werkte. Als er iets nieuws is gemaakt, zegt 201 meer.
Gedefinieerd in RFC 9110 §15.3.1
201
Created
Het verzoek is gelukt en heeft een of meer nieuwe resources aangemaakt.
Wanneer je hem gebruikt: Het antwoord op een POST of PUT die iets aanmaakte, met een Location-header die naar de nieuwe resource wijst.
Gedefinieerd in RFC 9110 §15.3.2
202
Accepted
Het verzoek is geaccepteerd voor verwerking, maar de verwerking is nog niet klaar en kan nog mislukken.
Wanneer je hem gebruikt: Voor werk dat op de achtergrond draait — een taak in de wachtrij, een bulkimport — liefst met een link waar de client de voortgang kan bekijken.
Gedefinieerd in RFC 9110 §15.3.3
203
Non-Authoritative Information
Het verzoek is gelukt, maar een proxy ertussen heeft het antwoord van de originele server veranderd.
Wanneer je hem gebruikt: Gestuurd door transformerende proxy's om te zeggen dat de inhoud niet precies is wat de bron stuurde. Zelden gezien.
Gedefinieerd in RFC 9110 §15.3.4
204
No Content
Het verzoek is gelukt en het antwoord heeft bewust geen body.
Wanneer je hem gebruikt: Een gebruikelijk antwoord op een DELETE, of op een PUT waarbij de client geen kopie terug nodig heeft.
Gedefinieerd in RFC 9110 §15.3.5
205
Reset Content
Het verzoek is gelukt en de client moet de weergave die het verstuurde resetten, bijvoorbeeld een formulier leegmaken.
Wanneer je hem gebruikt: Bedoeld voor invoerschermen die het formulier willen legen voor de volgende invoer. Browsers doen er in de praktijk weinig mee.
Gedefinieerd in RFC 9110 §15.3.6
206
Partial Content
De server stuurt alleen het deel van de resource dat de client in een Range-header vroeg.
Wanneer je hem gebruikt: Zo halen doorspoelen in video, hervatte downloads en downloadmanagers een bestand in stukken op.
Gedefinieerd in RFC 9110 §15.3.7
207
Multi-Status
Een WebDAV-antwoord waarvan de XML-body een aparte status bevat voor elk van meerdere resources.
Wanneer je hem gebruikt: Voor één verzoek dat op veel items werkte, waarvan sommige gelukt en andere mislukt kunnen zijn.
Gedefinieerd in RFC 4918
208
Already Reported
Gebruikt binnen een WebDAV-207-antwoord om te zeggen dat de leden van een resource eerder in hetzelfde antwoord al genoemd zijn.
Wanneer je hem gebruikt: Voorkomt dat hetzelfde item herhaald wordt als een collectie via meer dan één binding bereikbaar is.
Gedefinieerd in RFC 5842
226
IM Used
De server heeft een GET uitgevoerd en het antwoord is het resultaat van instance-manipulaties, zoals een delta, toegepast op de huidige resource.
Wanneer je hem gebruikt: Onderdeel van HTTP-delta-encoding (RFC 3229), waarbij een client alleen vraagt wat er sinds zijn kopie veranderd is. Zelden geïmplementeerd.
Gedefinieerd in RFC 3229
3xx · Doorverwijzing
300
Multiple Choices
De resource heeft meerdere representaties en de client of gebruiker moet er een kiezen.
Wanneer je hem gebruikt: Zelden gebruikt, omdat er geen standaardmanier is om automatisch te kiezen; servers kiezen er meestal zelf een en sturen die.
Gedefinieerd in RFC 9110 §15.4.1
301
Moved Permanently
De resource heeft een nieuw permanent adres, vermeld in de Location-header, en links moeten daarnaar worden aangepast.
Wanneer je hem gebruikt: Voor een pagina die voorgoed verhuisd is. Zoekmachines geven de ranking door aan het nieuwe adres. Een client mag bij het volgen van een POST een GET maken, dus gebruik 308 waar de methode ertoe doet.
Gedefinieerd in RFC 9110 §15.4.2
302
Found
Ook bekend als: Moved Temporarily
De resource staat tijdelijk op een ander adres, vermeld in de Location-header; het oorspronkelijke adres blijft het juiste.
Wanneer je hem gebruikt: Voor een kortstondige verhuizing, zoals bezoekers naar een inlogpagina sturen. Clients mogen bij het volgen POST in GET veranderen; 307 verbiedt dat.
Gedefinieerd in RFC 9110 §15.4.3
303
See Other
Het antwoord staat op een ander adres en de client moet het met een GET ophalen.
Wanneer je hem gebruikt: Het klassieke antwoord na een formulier-POST (Post/Redirect/Get), zodat het herladen van de resultaatpagina het formulier niet opnieuw verstuurt.
Gedefinieerd in RFC 9110 §15.4.4
304
Not Modified
De gecachete kopie van de client is nog actueel, dus de server stuurt geen body.
Wanneer je hem gebruikt: Het antwoord op een voorwaardelijke GET met If-None-Match of If-Modified-Since als er niets veranderd is. Geen fout: zo werkt caching.
Gedefinieerd in RFC 9110 §15.4.5
305
Use Proxy
Niet in gebruikVertelde de client ooit het verzoek te herhalen via de proxy die in de Location-header stond.
Wanneer je hem gebruikt: Om veiligheidsredenen afgeschaft, omdat een antwoord er verkeer mee kon omleiden via een proxy naar keuze. Stuur hem niet.
Gedefinieerd in RFC 9110 §15.4.6
306
(Unused)
Niet in gebruikGereserveerd. Een eerder concept definieerde hem als Switch Proxy, en hij is nooit gebruikt.
Wanneer je hem gebruikt: Stuur hem nooit. Het nummer blijft gereserveerd zodat het niet opnieuw wordt uitgegeven.
Gedefinieerd in RFC 9110 §15.4.7
307
Temporary Redirect
De resource staat tijdelijk op het adres in de Location-header, en de client moet het verzoek daar herhalen met dezelfde methode en body.
Wanneer je hem gebruikt: De tijdelijke doorverwijzing voor als een POST een POST moet blijven. HSTS-upgrades van http naar https verschijnen in browsers ook als een 307.
Gedefinieerd in RFC 9110 §15.4.8
308
Permanent Redirect
De resource is permanent verhuisd naar het adres in de Location-header, en de client moet dezelfde methode en body behouden.
Wanneer je hem gebruikt: Een permanente doorverwijzing voor een API of elk endpoint dat POST of PUT accepteert, waar een 301 het verzoek in een GET zou kunnen veranderen.
Gedefinieerd in RFC 9110 §15.4.9
4xx · Clientfout
400
Bad Request
De server kan het verzoek niet verwerken door iets wat hij als fout van de client ziet, zoals foutieve syntax.
Wanneer je hem gebruikt: Voor een verzoek dat helemaal niet te parsen is: kapotte JSON, een ongeldige header, een ontbrekende verplichte parameter.
Gedefinieerd in RFC 9110 §15.5.1
401
Unauthorized
Het verzoek mist geldige inloggegevens voor de resource. Ondanks de naam gaat het om authenticatie, niet om rechten.
Wanneer je hem gebruikt: Als de client niet is ingelogd of zijn token verlopen is. Het antwoord moet een WWW-Authenticate-header bevatten die zegt hoe je je authenticeert.
Gedefinieerd in RFC 9110 §15.5.2
402
Payment Required
Gereserveerd voor toekomstig gebruik. De specificatie heeft nooit vastgelegd wat hij moet doen.
Wanneer je hem gebruikt: Sommige API's sturen hem als een abonnement verlopen is of een betaling mislukte, maar er zit geen standaardgedrag achter.
Gedefinieerd in RFC 9110 §15.5.3
403
Forbidden
De server begreep het verzoek en weigert het uit te voeren. Dezelfde inloggegevens opnieuw sturen verandert het antwoord niet.
Wanneer je hem gebruikt: Als de gebruiker bekend is maar geen toegang heeft: het account van iemand anders, een beheerpagina, een geblokkeerd land of IP-adres.
Gedefinieerd in RFC 9110 §15.5.4
404
Not Found
De server heeft niets op dit adres, of wil niet zeggen of hij iets heeft.
Wanneer je hem gebruikt: Het antwoord op een kapotte link of een verkeerd getypte URL. Ook gebruikt in plaats van 403 om te verbergen dat een privéresource bestaat. Is hij voorgoed weg, dan zegt 410 dat.
Gedefinieerd in RFC 9110 §15.5.5
405
Method Not Allowed
De server kent de methode, maar deze resource ondersteunt hem niet.
Wanneer je hem gebruikt: Voor een POST naar een alleen-lezen-adres, of een DELETE waar niets te verwijderen valt. Het antwoord moet de toegestane methoden in een Allow-header noemen.
Gedefinieerd in RFC 9110 §15.5.6
406
Not Acceptable
De server kan geen antwoord maken in een formaat dat de client volgens zijn Accept-headers accepteert.
Wanneer je hem gebruikt: Content negotiation zonder gemeenschappelijke grond, zoals een client die alleen XML accepteert van een API die alleen JSON spreekt. De meeste servers sturen dan gewoon hun standaardformaat.
Gedefinieerd in RFC 9110 §15.5.7
407
Proxy Authentication Required
Zoals 401, maar het is een proxy tussen client en server die wil dat de client zich authenticeert.
Wanneer je hem gebruikt: Gestuurd door bedrijfsproxy's en andere authenticerende proxy's, met een Proxy-Authenticate-header die zegt hoe.
Gedefinieerd in RFC 9110 §15.5.8
408
Request Timeout
De server gaf het wachten op tot de client klaar was met het sturen van zijn verzoek.
Wanneer je hem gebruikt: Gestuurd op een inactieve verbinding voordat de server die sluit. Clients mogen het verzoek gewoon op een nieuwe verbinding herhalen.
Gedefinieerd in RFC 9110 §15.5.9
409
Conflict
Het verzoek botst met de huidige staat van de resource.
Wanneer je hem gebruikt: Een bewerking op basis van een verouderde versie, een gebruikersnaam die al bezet is, of het uploaden van een bestand waarvan de naam al in gebruik is.
Gedefinieerd in RFC 9110 §15.5.10
410
Gone
De resource stond hier vroeger en is bewust verwijderd, zonder nieuw adres.
Wanneer je hem gebruikt: Voor inhoud die voorgoed weg is. Het vertelt zoekmachines stelliger dan 404 dat de pagina niet terugkomt.
Gedefinieerd in RFC 9110 §15.5.11
411
Length Required
De server weigert een verzoek dat een body heeft maar geen Content-Length-header.
Wanneer je hem gebruikt: Gestuurd door servers die geen gechunkte uploads van onbekende lengte accepteren.
Gedefinieerd in RFC 9110 §15.5.12
412
Precondition Failed
Een voorwaarde in de headers van het verzoek, zoals If-Match of If-Unmodified-Since, werd niet vervuld.
Wanneer je hem gebruikt: Beschermt tegen verloren wijzigingen: de resource is veranderd sinds de client hem het laatst las, dus het schrijven wordt geweigerd.
Gedefinieerd in RFC 9110 §15.5.13
413
Content Too Large
Ook bekend als: Payload Too Large, Request Entity Too Large
De body van het verzoek is groter dan de server wil of kan verwerken. RFC 9110 hernoemde hem van Payload Too Large.
Wanneer je hem gebruikt: Een upload boven de groottelimiet. Is de limiet tijdelijk, dan zegt een Retry-After-header wanneer je het opnieuw kunt proberen.
Gedefinieerd in RFC 9110 §15.5.14
414
URI Too Long
Ook bekend als: Request-URI Too Long
De URI in het verzoek is langer dan de server wil lezen.
Wanneer je hem gebruikt: Meestal een formulier dat als GET wordt verstuurd met een enorme querystring, of een doorverwijzingslus die steeds iets aan de URL toevoegde. Stuur de gegevens in plaats daarvan als POST-body.
Gedefinieerd in RFC 9110 §15.5.15
415
Unsupported Media Type
De server weigert het verzoek omdat de body in een formaat is dat hij niet ondersteunt.
Wanneer je hem gebruikt: Een verkeerde of ontbrekende Content-Type, zoals formuliergegevens naar een endpoint dat alleen application/json aanneemt.
Gedefinieerd in RFC 9110 §15.5.16
416
Range Not Satisfiable
Ook bekend als: Requested Range Not Satisfiable
Geen van de bereiken in de Range-header van het verzoek overlapt met de resource.
Wanneer je hem gebruikt: Bytes vragen voorbij het einde van het bestand, vaak een hervatte download van een bestand dat inmiddels kleiner is geworden.
Gedefinieerd in RFC 9110 §15.5.17
417
Expectation Failed
De server kan niet voldoen aan de eis in de Expect-header van het verzoek.
Wanneer je hem gebruikt: Vooral te zien als een proxy of server Expect: 100-continue niet ondersteunt. Opnieuw proberen zonder die header werkt meestal.
Gedefinieerd in RFC 9110 §15.5.18
418
(Unused)
Niet in gebruikOok bekend als: I'm a teapot
De 1-aprilcode uit RFC 2324: een theepot die weigert koffie te zetten. RFC 9110 reserveert het nummer zodat het nooit een echte betekenis krijgt.
Wanneer je hem gebruikt: Niet voor productie. Sommige sites sturen hem als easter egg of om bots af te wijzen, maar je kunt niet verwachten dat clients hem begrijpen.
Gedefinieerd in RFC 9110 §15.5.19
421
Misdirected Request
Het verzoek kwam terecht bij een server die geen antwoord kan maken voor de host die erin staat.
Wanneer je hem gebruikt: Gebeurt vooral bij hergebruik van HTTP/2-verbindingen, als één verbinding gedeeld wordt over hostnamen waarvoor de server niet is ingericht. De client moet het opnieuw proberen op een nieuwe verbinding.
Gedefinieerd in RFC 9110 §15.5.20
422
Unprocessable Content
Ook bekend als: Unprocessable Entity
De server begrijpt het inhoudstype en de syntax klopt, maar hij kan niet verwerken wat het verzoek bevat. Vroeger Unprocessable Entity.
Wanneer je hem gebruikt: Het gebruikelijke antwoord op een validatiefout in een goed gevormd verzoek. Sinds RFC 9110 deel van HTTP zelf, niet alleen van WebDAV.
Gedefinieerd in RFC 9110 §15.5.21
423
Locked
De WebDAV-resource die wordt benaderd is vergrendeld.
Wanneer je hem gebruikt: Een bestand dat een andere gebruiker heeft vergrendeld om te bewerken.
Gedefinieerd in RFC 4918
424
Failed Dependency
Het verzoek is mislukt omdat een andere actie waarvan het afhing mislukte.
Wanneer je hem gebruikt: In een WebDAV-batch de operaties die niet konden draaien omdat een eerdere in hetzelfde verzoek mislukte.
Gedefinieerd in RFC 4918
425
Too Early
De server wil niet het risico lopen een verzoek te verwerken dat opnieuw afgespeeld zou kunnen worden.
Wanneer je hem gebruikt: Voor verzoeken die als TLS 1.3-early data (0-RTT) zijn gestuurd, die een aanvaller zou kunnen herhalen. De client moet het opnieuw proberen zodra de handshake klaar is.
Gedefinieerd in RFC 8470
426
Upgrade Required
De server weigert het verzoek via het huidige protocol, maar zou het accepteren nadat de client is overgestapt.
Wanneer je hem gebruikt: Gestuurd met een Upgrade-header die het vereiste protocol noemt, bijvoorbeeld een nieuwere versie van HTTP of TLS.
Gedefinieerd in RFC 9110 §15.5.22
428
Precondition Required
De server eist dat het verzoek voorwaardelijk is, met een header zoals If-Match.
Wanneer je hem gebruikt: Dwingt clients te laten zien welke versie ze wijzigen, zodat twee bewerkingen elkaar niet ongemerkt kunnen overschrijven.
Gedefinieerd in RFC 6585
429
Too Many Requests
De client heeft te veel verzoeken gestuurd binnen een bepaalde tijd.
Wanneer je hem gebruikt: Rate limiting. Een Retry-After-header zegt hoe lang je moet wachten; clients horen terug te schakelen in plaats van meteen opnieuw te proberen.
Gedefinieerd in RFC 6585
431
Request Header Fields Too Large
De server verwerkt het verzoek niet omdat de headers, of één header, te groot zijn.
Wanneer je hem gebruikt: Meestal een te grote cookie, of te veel cookies voor één domein. De cookies van de site wissen lost het meestal op.
Gedefinieerd in RFC 6585
451
Unavailable For Legal Reasons
De server weigert toegang tot de resource vanwege een juridische eis.
Wanneer je hem gebruikt: Inhoud die geblokkeerd is door een rechterlijk bevel, een overheidsverzoek of een verwijdering in één land. Het nummer verwijst naar de roman Fahrenheit 451.
Gedefinieerd in RFC 7725
5xx · Serverfout
500
Internal Server Error
De server liep tegen een onverwachte situatie aan waardoor hij het verzoek niet kon uitvoeren.
Wanneer je hem gebruikt: De verzamelcode voor een crash of een onafgehandelde exception. De eigen logs van de server zeggen wat er echt gebeurde; de client kan het meestal niet oplossen.
Gedefinieerd in RFC 9110 §15.6.1
501
Not Implemented
De server ondersteunt de functionaliteit niet die nodig is om het verzoek uit te voeren.
Wanneer je hem gebruikt: Een methode die de server helemaal niet herkent. Anders dan 405 betekent hij dat geen enkele resource op deze server hem ondersteunt.
Gedefinieerd in RFC 9110 §15.6.2
502
Bad Gateway
Een server die als gateway of proxy werkt kreeg een ongeldig antwoord, of geen antwoord, van de server erachter.
Wanneer je hem gebruikt: De applicatie achter nginx, een load balancer of een CDN is gecrasht, start opnieuw op of is onbereikbaar.
Gedefinieerd in RFC 9110 §15.6.3
503
Service Unavailable
De server kan het verzoek nu niet aan, omdat hij overbelast is of plat ligt voor onderhoud.
Wanneer je hem gebruikt: Een tijdelijke situatie. Stuur een Retry-After-header die zegt wanneer je terug kunt komen; zoekmachines zien een 503 als tijdelijk en houden de pagina.
Gedefinieerd in RFC 9110 §15.6.4
504
Gateway Timeout
Een server die als gateway of proxy werkt kreeg niet op tijd een antwoord van de server erachter.
Wanneer je hem gebruikt: Een trage databasequery of een backend die langer over zijn antwoord doet dan de time-out van de proxy.
Gedefinieerd in RFC 9110 §15.6.5
505
HTTP Version Not Supported
De server ondersteunt de hoofdversie van HTTP niet die in het verzoek wordt gebruikt.
Wanneer je hem gebruikt: Zeldzaam, want bijna elke server spreekt HTTP/1.1, HTTP/2 en vaak HTTP/3.
Gedefinieerd in RFC 9110 §15.6.6
506
Variant Also Negotiates
Een configuratiefout van de server bij transparante content negotiation: de gekozen variant is zelf ingesteld om te onderhandelen, wat een lus zou opleveren.
Wanneer je hem gebruikt: Komt uit experimentele content negotiation (RFC 2295) en is bijna nooit te zien.
Gedefinieerd in RFC 2295
507
Insufficient Storage
De server kan niet opslaan wat hij voor het verzoek moet opslaan.
Wanneer je hem gebruikt: Een WebDAV-upload of -kopie als de schijf of het quotum van de gebruiker vol is.
Gedefinieerd in RFC 4918
508
Loop Detected
De server stopte een WebDAV-operatie omdat hij een oneindige lus vond.
Wanneer je hem gebruikt: Een verzoek met Depth: infinity over bindings die naar elkaar terugverwijzen.
Gedefinieerd in RFC 5842
510
Not Extended
Niet in gebruikHet verzoek heeft extra extensies nodig die de server eist voordat hij het uitvoert.
Wanneer je hem gebruikt: Komt uit het HTTP Extension Framework (RFC 2774), dat inmiddels de status historisch heeft, en het register markeert de code als verouderd. Stuur hem niet.
Gedefinieerd in RFC 2774
511
Network Authentication Required
De client moet zich authenticeren om überhaupt netwerktoegang te krijgen.
Wanneer je hem gebruikt: Gestuurd door captive portals, zoals de wifi-inlogpagina's van hotels of luchthavens, die verkeer onderscheppen tot de gebruiker inlogt.
Gedefinieerd in RFC 6585