Wat betekenen de HTTP-statuscodes?

Dit artikel bevat een compacte lijst met HTTP-statuscodes die je tijdens een API-aanroep kunt tegenkomen. Wat betekenen deze scodes en wat zijn de mogelijke oorzaken die in de statuscode resulteren?

 


 

 

HTTP Omschrijving Betekenis
2xx Success  
200 Succesvol Verzoek succesvol verwerkt (kan ook lege dataset retourneren)
3xx Redirection  
302 Tijdelijk verplaatst Resource tijdelijk verplaatst (vaak door foutieve headers)
313 Ongeldig bestand Het opgegeven bestand is ongeldig of corrupt
4xx Client errors  
400 Ongeldig verzoek Ongeldig verzoek: verkeerde parameters, json, headers, API-versie of URL
401 Niet ingelogd Niet geauthentiseerd: ontbrekende of ongeldige inloggegevens of token
403 Geen toegang Geen rechten voor dit endpoint of deze service
404 Niet gevonden Resource, endpoint of sleutel niet gevonden
405 Methode niet toegestaan HTTP-methode (GET/POST/PUT/DEL) niet toegestaan voor deze resource
415 Niet-ondersteund formaat Contenttype wordt niet ondersteund (bijvoorbeeld ontbrekende application/json)
422 Ongeldige invoer Verzoek correct van vorm, maar inhoud ongeldig of validatiemeldingen
423 Vergrendeld Resource is vergrendeld (record-lock)
426 Ongeldige configuratie Ongeldig document, collectie, lay-out, instelling of bestand
429 Te veel verzoeken Te veel verzoeken in korte tijd (rate limit overschreden)
449 Bevestiging vereist Gebruikersinteractie of bevestiging is vereist om verder te gaan
455 Add-on niet beschikbaar Vereiste add-on-sleutel is niet beschikbaar of niet geactiveerd
460 Bestandsnaam ontbreekt Bestandsnaam ontbreekt in het verzoek
496 Ongeldige API-key API-sleutel ontbreekt of is ongeldig
497 Actie niet toegestaan Ongeldige actie of MKG Exchange-licentie is niet actief
498 Ongeldige sessie Token verlopen/ongeldig of applicatie onbekend
499 Interne fout (client) Interne fout aan client- of tussenlaag-zijde
5xx Server errors  
500 Serverfout Onverwachte serverfout (zie _retVal-codes)
501 Niet geïmplementeerd Functionaliteit is (nog) niet geïmplementeerd
502 Verbindingsfout Bad gateway: probleem tussen Tomcat en Progress
503 Niet beschikbaar Service tijdelijk overbelast of in onderhoud
504 Time-out Gateway time-out: upstream-server reageert te traag
     
_retVal   Betekenis
4000   Onbekende fout bij aanroepen MKG-gebruiker
4010   MKG-gebruiker is niet actief
4020   MKG-gebruiker heeft geen complex wachtwoord
4030   Sessie is verlopen
4050   JSESSIONID is leeg
7211   Server terminated unexpectedly – foutieve request