Wat HTTP-statuscodes betekenen

Elke keer dat je browser een pagina laadt of een app een API aanroept, antwoordt de server met een driecijferige statuscode. Meestal zie je hem nooit, maar wanneer er iets breekt — een 404, een 500 — is dat getal de eerste aanwijzing. Deze gids leert je statuscodes in één oogopslag te lezen.

Lees het eerste cijfer

De truc is dat het eerste cijfer je de categorie vertelt, zodat je de bedoeling van een nooit eerder geziene code kunt begrijpen:

• 1xx — Informational: ontvangen, nog aan het verwerken (zeldzaam in dagelijks gebruik).
• 2xx — Success: het werkte.
• 3xx — Redirection: de bron staat ergens anders.
• 4xx — Client error: het verzoek was fout (jouw kant).
• 5xx — Server error: het verzoek was prima, de server faalde.

Die splitsing 4xx tegen 5xx is bij het debuggen het nuttigste onderscheid: 4xx betekent herstel het verzoek; 5xx betekent dat de server de schuld heeft.

De codes die je echt tegenkomt

Succes en omleidingen

• 200 OK — het standaardantwoord „het werkte”.
• 201 Created — een nieuwe bron is aangemaakt (na een POST).
• 301 Moved Permanently — deze URL is permanent verhuisd; werk je links bij. Belangrijk voor SEO.
• 302 Found — een tijdelijke omleiding; blijf de oorspronkelijke URL gebruiken.
• 304 Not Modified — je gecachte kopie is nog geldig, dus er is niets opnieuw verzonden.

Clientfouten (4xx)

• 400 Bad Request — het verzoek was misvormd.
• 401 Unauthorized — je moet je authenticeren (inloggen).
• 403 Forbidden — je bent geauthenticeerd maar niet toegestaan.
• 404 Not Found — de bron bestaat niet.
• 429 Too Many Requests — je wordt rate-limited; doe rustiger aan.

Serverfouten (5xx)

• 500 Internal Server Error — een generieke serverzijdige storing.
• 502 Bad Gateway — een upstream-server gaf een slecht antwoord terug.
• 503 Service Unavailable — de server is overbelast of uit voor onderhoud.
• 504 Gateway Timeout — een upstream-server antwoordde niet op tijd.

401 vs. 403: een veelvoorkomende verwarring

Deze twee voelen vergelijkbaar maar verschillen in één woord. 401 Unauthorized betekent eigenlijk „niet geauthenticeerd” — de server weet niet wie je bent, dus log in. 403 Forbidden betekent dat de server weet wie je bent en je nog steeds niet toegestaan bent. Het een gaat over identiteit, het ander over toestemming.

De volledige lijst

Voor elke geregistreerde code met zijn betekenis — doorzoekbaar en gegroepeerd per klasse — zie onze volledige HTTP-statuscodes-referentie. Als je API-antwoorden debugt, behandelen onze gidsen over JWT's en URL-codering twee andere dingen die je constant tegenkomt.