|
400
|
Bad Request
RFC 9110
|
De server kan de request niet verwerken omdat syntaxis, parameters, headers of body ongeldig zijn. |
Gebruikelijk bij ongeldige JSON, ontbrekende verplichte waarden, verkeerd gevormde URLs of afwijkende headers. |
Controleer het requestbodyformaat, Content-Type, queryparameters en servervalidatielogs.
Gerelateerd: 422
|
|
401
|
Unauthorized
RFC 9110
|
Authenticatie is vereist of de opgegeven credentials zijn ongeldig. |
Wordt gebruikt wanneer een logintoken ontbreekt, een API-key is verlopen of de Authorization-header onjuist is. |
Controleer de WWW-Authenticate-header, tokenverval, het authenticatieschema en of cookies worden verzonden.
Gerelateerd: 403, 407
|
|
402
|
Payment Required
RFC 9110
|
Gereserveerd voor scenario's waarin betaling vereist is, maar de standaardbetekenis is niet breed vastgesteld. |
Sommige API's en betaaldiensten gebruiken dit onofficieel voor problemen met betaling, tegoed of abonnement. |
Controleer de servicespecifieke API-documentatie voor de werkelijke betekenis van 402 en het herstelpad.
Gerelateerd: 403, 429
|
|
403
|
Forbidden
RFC 9110
|
De server begreep de request, maar weigert toegang toe te staan. |
Gebruikelijk bij onvoldoende rechten, IP-blokkades, administratief beleid of toegang tot private resources. |
Controleer autorisatiebeleid, ACLs, WAF-regels, bestandsrechten en routeringsregels los van authenticatie.
Gerelateerd: 401, 404, 451
|
|
404
|
Not Found
RFC 9110
|
De gevraagde resource kan niet worden gevonden, of de server geeft niet prijs of die bestaat. |
Het meest voorkomend bij URL-typfouten, verwijderde pagina's, onjuiste routes of bewust verborgen resources. |
Controleer interne links, sitemaps, redirects, routeringstabellen en vervangende URLs voor verwijderde inhoud.
Gerelateerd: 410, 403, 451
|
|
405
|
Method Not Allowed
RFC 9110
|
De resource bestaat, maar de gevraagde HTTP-methode is niet toegestaan. |
Komt voor wanneer POST naar een alleen-GET URL wordt gestuurd of wanneer een API-route voor andere methoden is geconfigureerd. |
Controleer de Allow-header, routermethode-definities en proxybeleid voor methodebeperkingen.
Gerelateerd: 404, 501
|
|
406
|
Not Acceptable
RFC 9110
|
De server kan geen representatie leveren die overeenkomt met de Accept-headers van de client. |
Kan voorkomen wanneer de client alleen niet-ondersteunde mediatypen, talen of encodings aanvraagt. |
Controleer de Accept-, Accept-Language- en Accept-Encoding-headers en de content negotiation-instellingen van de server.
Gerelateerd: 415
|
|
407
|
Proxy Authentication Required
RFC 9110
|
Authenticatie is vereist voordat de client de proxy kan gebruiken. |
Te zien in bedrijfsnetwerken, security proxies en gateway-authenticatieomgevingen. |
Controleer Proxy-Authenticate- en Proxy-Authorization-headers en de netwerkproxyconfiguratie.
Gerelateerd: 401, 305
|
|
408
|
Request Timeout
RFC 9110
|
De server ontving de volledige clientrequest niet binnen de tijd die hij wilde wachten. |
Kan gebeuren bij trage netwerken, grote uploads, keep-alive timeouts of load balancer timeouts. |
Controleer retrygedrag van de client, uploadgrootte, keep-alive instellingen en proxy-timeoutwaarden.
Gerelateerd: 504
|
|
409
|
Conflict
RFC 9110
|
De request conflicteert met de huidige staat van de resource. |
Vaak gebruikt voor dubbele creatie, versieconflicten, gelijktijdige bewerkingen of ongeldige statustransities. |
Controleer resourceversies, ETags, dubbele keys en bedrijfsregels voor statustransities.
Gerelateerd: 412, 422
|
|
410
|
Gone
RFC 9110
|
De resource bestond eerder, maar is permanent verwijderd. |
Specifieker dan 404 wanneer u zoekmachines en clients duidelijk wilt vertellen dat een pagina is verwijderd. |
Gebruik 301 als er een vervangende URL is; gebruik 410 met sitemapopschoning wanneer permanente verwijdering correct is.
Gerelateerd: 404, 301
|
|
411
|
Length Required
RFC 9110
|
De server weigert de request omdat Content-Length ontbreekt. |
Kan voorkomen wanneer een server of gateway de lengte van de requestbody vooraf moet weten. |
Controleer Content-Length, Transfer-Encoding en het streaminggedrag van de clientbibliotheek.
Gerelateerd: 413
|
|
412
|
Precondition Failed
RFC 9110
|
Een precondition in een conditionele request, zoals If-Match, is mislukt. |
Wordt gebruikt voor het voorkomen van gelijktijdige bewerkingsconflicten, cache revalidatie en ETag-gebaseerde updates. |
Vergelijk If-Match, If-None-Match en If-Unmodified-Since met de huidige resourceversie.
Gerelateerd: 304, 409, 428
|
|
413
|
Content Too Large
RFC 9110
|
De requestbody is groter dan de server wil accepteren. |
Gebruikelijk bij bestandsuploadlimieten, JSON-bodygrootte-limieten en proxybeperkingen voor bodygrootte. |
Controleer uploadlimieten in server, proxy, CDN en applicatie.
Gerelateerd: 411, 431
|
|
414
|
URI Too Long
RFC 9110
|
De request-URI is langer dan de server kan verwerken. |
Kan gebeuren bij zeer lange querystrings, defecte redirectloops of te veel data in een GET-URL. |
Verplaats lange data naar een POST-body en controleer URI-lengtelimieten in proxies en servers.
Gerelateerd: 400, 431
|
|
415
|
Unsupported Media Type
RFC 9110
|
De server ondersteunt het mediatype van de requestbody niet. |
Komt voor wanneer een JSON-API de verkeerde Content-Type ontvangt of een niet-ondersteund bestandsformaat wordt geüpload. |
Controleer Content-Type, bestandsextensie, multipart-instellingen en of de serverparser is geregistreerd.
Gerelateerd: 406, 422
|
|
416
|
Range Not Satisfiable
RFC 9110
|
De gevraagde Range kan niet worden geleverd omdat die niet past binnen de resourcegrootte. |
Komt voor bij hervatbare downloads of streaming wanneer de gevraagde range buiten de bestandsgrootte valt. |
Controleer de Range-header, Content-Range, bestandsgrootte en verouderde cachemetadata.
Gerelateerd: 206
|
|
417
|
Expectation Failed
RFC 9110
|
De server kan niet voldoen aan de verwachting in de Expect-header. |
Kan voorkomen wanneer een server of proxy verwachtingen zoals Expect: 100-continue niet ondersteunt. |
Verwijder de Expect-header of bevestig dat de server 100 Continue-afhandeling ondersteunt.
Gerelateerd: 100
|
|
418
|
I'm a teapot
RFC 2324 / RFC 9110
|
Een code afkomstig uit een April Fools' RFC, vooral met historische en culturele betekenis in plaats van praktische foutafhandeling. |
Sommige services gebruiken dit voor speelse responses, tests of ontwikkelaarscultuur, maar het wordt niet aanbevolen voor gewoon API-ontwerp. |
Gebruik voor productie-API's een duidelijke 4xx- of 5xx-statuscode met een goed gedefinieerde betekenis.
Gerelateerd: 400
|
|
421
|
Misdirected Request
RFC 9110
|
De request is naar een server gestuurd die er geen response voor kan produceren. |
Kan gebeuren wanneer HTTP/2 connection reuse, TLS/SNI, CDN of reverse proxy-routering verkeerd is geconfigureerd. |
Controleer Host, SNI, certificaten, HTTP/2 connection coalescing en CDN-origin-routering.
Gerelateerd: 400, 502
|
|
422
|
Unprocessable Content
RFC 9110
|
De requestsyntaxis is geldig, maar de inhoud kan semantisch niet worden verwerkt. |
Gebruikelijk bij API-validatiefouten, schendingen van bedrijfsregels en ongeldige veldwaarden. |
Bepaal in uw API-regels of 400 formaatfouten betekent en 422 semantische of validatiefouten.
Gerelateerd: 400, 409, 415
|
|
423
|
Locked
RFC 4918
|
De doelresource is vergrendeld, dus de request kan niet worden verwerkt. |
Wordt gebruikt voor bestandsbewerkingslocks, samenwerkingsdocumenten en WebDAV-resourcelocks. |
Controleer lockeigenaar, lockverval, unlock-API en beleid voor conflictafhandeling.
Gerelateerd: 409, 424
|
|
424
|
Failed Dependency
RFC 4918
|
De huidige request kan niet worden uitgevoerd omdat een eerdere afhankelijke bewerking is mislukt. |
Wordt gebruikt wanneer meerdere bewerkingen van elkaar afhangen en het falen van een eerdere bewerking een latere laat falen. |
Maak de mislukte eerdere bewerking en de afhankelijkheidsrelatie duidelijk in de responsebody.
Gerelateerd: 207, 423
|
|
425
|
Too Early
RFC 8470
|
De server weigert een request te verwerken die mogelijk te vroeg en riskant is om opnieuw af te spelen. |
Kan worden gebruikt met TLS 1.3 0-RTT early data wanneer er risico op replay-aanvallen bestaat. |
Zorg dat niet-idempotente requests niet met 0-RTT worden verzonden en controleer client- en serverinstellingen.
Gerelateerd: 429, 503
|
|
426
|
Upgrade Required
RFC 9110
|
De server vereist dat de client protocollen upgradet voordat de request wordt afgehandeld. |
Wordt gebruikt wanneer een specifieke upgrade vereist is, zoals een HTTP-versie, TLS of WebSocket. |
Controleer de Upgrade-header, ondersteunde protocollen en of proxies upgrade-requests doorsturen.
Gerelateerd: 101
|
|
428
|
Precondition Required
RFC 6585
|
De server vereist een conditionele requestheader. |
Wordt gebruikt om verloren updates bij gelijktijdige bewerkingen te voorkomen door een voorwaarde zoals If-Match te eisen. |
Bied API-documentatie en foutmeldingen die clients vertellen de ETag te lezen en met If-Match bij te werken.
Gerelateerd: 412, 409
|
|
429
|
Too Many Requests
RFC 6585
|
De client stuurde te veel requests binnen een bepaalde periode. |
Gebruikelijk bij API-rate limits, limieten op loginpogingen, botblokkering en overmatig verversen. |
Controleer Retry-After, rate limit-headers, limieten per gebruiker of token en backoffstrategie.
Gerelateerd: 403, 503
|
|
431
|
Request Header Fields Too Large
RFC 6585
|
De totale requestheaders of een specifiek headerveld zijn te groot. |
Kan voorkomen wanneer cookies te groot worden of authenticatietokens, trackingheaders of proxy-toegevoegde headers zich opstapelen. |
Verklein Cookie, de Authorization-header en headers die door proxyketens worden toegevoegd.
Gerelateerd: 400, 413, 414
|
|
451
|
Unavailable For Legal Reasons
RFC 7725
|
De resource kan om juridische redenen niet worden geleverd. |
Wordt gebruikt wanneer toegang tot inhoud is beperkt door gerechtelijke bevelen, overheidsverzoeken, copyrightmeldingen of lokale regelgeving. |
Bevestig dat de code transparant een juridische vereiste aangeeft, anders dan een generieke 403 of 404.
Gerelateerd: 403, 404, 410
|