Referentie van HTTP-statuscodes
| Code | Name | Betekenis |
|---|---|---|
| 100 | Doorgaan | Client moet doorgaan met de request body |
| 101 | Protocollen wisselen | Protocolupgrade geaccepteerd (bijv. naar WebSocket) |
| 200 | OK | Het verzoek is geslaagd — de standaard succesrespons |
| 201 | Aangemaakt | Er is een nieuwe resource aangemaakt (typisch POST-succes) |
| 202 | Geaccepteerd | In wachtrij voor async verwerking, nog niet voltooid |
| 204 | Geen inhoud | Geslaagd met een opzettelijk lege body |
| 301 | Permanent verplaatst | Resource heeft een nieuwe permanente URL — werk links bij; SEO-waarde gaat mee over |
| 302 | Gevonden | Tijdelijke omleiding (historisch misbruikt; zie 303/307) |
| 303 | Zie andere | Omleiding naar een GET op een andere URL (post/redirect/get) |
| 304 | Niet gewijzigd | Gecachte kopie is nog geldig — hervalideer via ETag/Last-Modified |
| 307 | Tijdelijke omleiding | Tijdelijke omleiding met behoud van methode en body |
| 308 | Permanente omleiding | Permanente omleiding met behoud van methode en body |
| 400 | Bad Request | De server kan het verzoek niet parseren/begrijpen |
| 401 | Niet geautoriseerd | Authenticatie vereist of mislukt (ondanks de naam betekent het niet-geauthenticeerd) |
| 403 | Verboden | Geauthenticeerd of niet, toegang wordt geweigerd |
| 404 | Niet gevonden | Geen resource op deze URL |
| 405 | Methode niet toegestaan | De HTTP-methode wordt niet ondersteund voor deze resource |
| 406 | Niet aanvaardbaar | Geen representatie komt overeen met de Accept-headers |
| 408 | Time-out van verzoek | De client deed er te lang over om het verzoek te sturen |
| 409 | Conflict | Statusconflict, bijv. bewerkingsbotsing of dubbele aanmaak |
| 410 | Gone | Permanent verwijderd (sterker dan 404 — bewust gebruikt) |
| 411 | Lengte vereist | Content-Length-header is vereist |
| 413 | Inhoud te groot | Request body overschrijdt serverlimieten |
| 414 | URI te lang | De URL overschrijdt serverlimieten |
| 415 | Niet-ondersteund mediatype | Het Content-Type van het verzoek wordt niet ondersteund |
| 418 | I'm a Teapot | RFC 2324-grapcode, soms gebruikt om koffiezetten te weigeren |
| 422 | Onverwerkbare inhoud | Syntax is prima maar semantiek faalt op validatie (API's zijn hier dol op) |
| 425 | Te vroeg | Server wil een mogelijk opnieuw afgespeeld verzoek niet verwerken |
| 429 | Te veel verzoeken | Rate limit bereikt — wacht, respecteer Retry-After |
| 500 | Interne serverfout | Generieke serverfout |
| 501 | Niet geïmplementeerd | De server ondersteunt de functionaliteit niet |
| 502 | Bad Gateway | Een proxy/gateway kreeg een ongeldig antwoord van upstream |
| 503 | Service niet beschikbaar | Overbelast of offline voor onderhoud — vaak tijdelijk, kan Retry-After bevatten |
| 504 | Gateway-time-out | Een proxy/gateway time-outte tijdens het wachten op upstream |
| 505 | HTTP-versie niet ondersteund | De HTTP-versie in het verzoek wordt niet ondersteund |
Over ons
Statuscodes zijn de samenvatting in één getal van de server van elke response, gegroepeerd per klasse: 1xx informatief, 2xx succes, 3xx omleiding, 4xx de client maakte een fout, 5xx de server maakte een fout. De tabel geeft de codes die werkende developers echt tegenkomen, met de nuances die er in de praktijk toe doen — 401 betekent niet-geauthenticeerd ondanks zijn naam, 403 is een weigering ongeacht inloggen, 422 is de API-validatiefout, 429 eist backoff. Codes die niet vermeld staan (de lange staart van 1xx en experimentele codes) zijn zeldzaam genoeg dat de klasse alleen je vertelt hoe je ze moet behandelen.
Veelgestelde vragen
Wat is het verschil tussen 401 en 403?
401: we weten niet wie je bent (authenticeer). 403: we weten het, en je mag nog steeds niet.
302 of 307 voor een tijdelijke omleiding?
307 behoudt de methode en body; 302 liet clients historisch POST naar GET wisselen. Nieuw werk moet 307 gebruiken (of 308 voor permanent).