Hier zijn enkele voorbeelden van mogelijke foutresponses die de API kan retourneren, afhankelijk van de situatie:

1. Ongeldig Token

Wanneer het opgegeven token ongeldig of verlopen is.

{
    "error": "Unauthorized",
    "message": "Het opgegeven token is ongeldig of verlopen.",
    "HTTP": 401
}

2. Lidnummer Niet Gevonden

Wanneer het opgegeven lidnummer niet bestaat in de database.

{
    "error": "Not Found",
    "message": "Het opgegeven lidnummer is niet gevonden.",
    "HTTP": 404
}

3. Verplichte Velden Ontbreken

Wanneer verplichte velden in de body ontbreken.

{
    "error": "Bad Request",
    "message": "Het veld 'LidNr' is verplicht.",
    "HTTP": 400
}

4. Geen Toegang tot Endpoint

Wanneer de gebruiker geen rechten heeft om het endpoint te gebruiken.

{
    "error": "Forbidden",
    "message": "Je hebt geen toegang tot dit endpoint.",
    "HTTP": 403
}

5. Onjuiste Request-Body

Wanneer de request-body niet in het juiste formaat is (bijvoorbeeld verkeerd geformatteerde JSON)

{
    "error": "Bad Request",
    "message": "De JSON-structuur van de aanvraag is ongeldig.",
    "HTTP": 400
}

6. Rate Limiting

Wanneer het aantal toegestane API-aanroepen per tijdsperiode is overschreden.

{
    "error": "Too Many Requests",
    "message": "Het aantal toegestane verzoeken is overschreden. Probeer het later opnieuw.",
    "HTTP": 429
}

7. Interne Serverfout

Wanneer er een probleem optreedt op de server.

{
    "error": "Internal Server Error",
    "message": "Er is een interne serverfout opgetreden. Neem contact op met de ondersteuning.",
    "HTTP": 500
}

8. Endpoint Niet Gevonden

Wanneer het gevraagde endpoint niet bestaat of verkeerd is geconfigureerd.

{
    "error": "Not Found",
    "message": "Het gevraagde endpoint is niet gevonden.",
    "HTTP": 404
}

9. Verkeerde HTTP-methode

Wanneer een onjuiste HTTP-methode (bijvoorbeeld GET in plaats van POST) wordt gebruikt.

{
    "error": "Method Not Allowed",
    "message": "Gebruik de juiste HTTP-methode voor dit endpoint. Vereist: POST.",
    "HTTP": 405
}

Tips bij Fouten

• Controleer de headers: Zorg ervoor dat de Authorization-header correct is ingesteld.

• Valideer de JSON-body: Controleer of alle verplichte velden aanwezig zijn en correct geformatteerd zijn.

• Rate limiting: Zorg ervoor dat je niet meer verzoeken stuurt dan toegestaan.

• Contact ondersteuning: Bij een 500-fout kun je contact opnemen met de API-beheerder voor hulp.