Je stuurt data naar een server, bijvoorbeeld een formulier met een bestand, een API-call of een grote JSON-payload, en krijgt direct een foutmelding terug: 413 Request Entity Too Large.
De status code 413 is de manier waarop een server zegt: wat je me stuurt, is groter dan ik wil accepteren. Niet omdat het stuk is. Niet omdat het onjuist is opgebouwd. Puur vanwege de omvang.
Wat gebeurt er precies bij een 413?
Een 413-fout ontstaat op het moment dat de server je verzoek binnenkrijgt, de headers leest en vervolgens besluit: dit lichaam (de body) is te groot. Het verzoek wordt niet verder verwerkt. Geen parse, geen opslag, geen verwerking. Gewoon direct afkappen.
Soms wordt dit veroorzaakt door een bestand dat je uploadt. Soms door een oversized JSON-array. En soms door iets onverwachts: een gebruiker die een rich textveld vult met enorme embedded content, bijvoorbeeld.
De response ziet er meestal zo uit:
HTTP/1.1 413 Request Entity Too Large
In de praktijk betekent dit dat je ofwel je payload moet verkleinen, of je server moet aanpassen.
Wat bepaalt wat “te groot” is?
Dat hangt af van de softwarestack.
- In Nginx is de grens ingesteld via client_max_body_size
- Apache gebruikt LimitRequestBody
- In PHP zit het in post_max_size en upload_max_filesize
- Express.js en andere Node-frameworks hebben hun eigen middlewarelimieten
Soms zit er ook nog een reverse proxy tussen, zoals Varnish of een API Gateway, die eigen grenzen hanteert. Die kunnen al eerder ingrijpen.
Waar zie je dit fouttype terug?
Vooral bij toepassingen die bestandsverwerking doen. Denk aan:
- Uploadformulieren met afbeeldingen of video’s,
- API’s die bulkdata accepteren,
- Of frontends die grote inputs doorsturen zonder validatie.
Een typische situatie: een gebruiker probeert een video van 50MB te uploaden naar een endpoint dat maximaal 10MB toestaat. Resultaat: 413 request entity too large.
Hoe los je het op?
Dat hangt af van waar je controle hebt.
Als je client bent:
- Verklein je payload. Denk aan het comprimeren van afbeeldingen of splitsen van data.
- Beperk de hoeveelheid records in één API-call.
- Voeg validatie toe vóór verzending om oversized content te blokkeren.
Als je server beheert:
- Verhoog indien nodig de limiet (bewust en gecontroleerd).
- In Nginx bijvoorbeeld:
client_max_body_size 20M; - In PHP:
post_max_size = 20M
upload_max_filesize = 20M
Maar denk wel na over waarom je de limiet aanpast. Grotere uploads vragen om extra servercapaciteit, logging, validatie en beveiliging.
Tot slot
De 413 status code is niet complex, maar wel belangrijk. Het is een waarschuwing dat je systeem probeert te verwerken wat het niet aankan, of niet wil verwerken op basis van ingestelde grenzen.
Zie het niet als een crash, maar als een grens die je bewust moet beheren. Met geoptimaliseerde WordPress Hosting, schaalbare Cloud Hosting of gespecialiseerde WooCommerce Hosting zorg je dat uploads en API-verkeer passen bij de manier waarop je applicatie bedoeld is te functioneren.
Want groter is niet per se beter. En een 413 komt zelden uit het niets.
