Docs/Foutafhandeling

Foutafhandeling

Alle API-fouten hebben een consistent formaat. Zo vang je ze netjes af.

Markdown bekijken OpenAPI JSON

Formaat van foutresponses

Als er een fout optreedt, retourneert de API een JSON-object met deze structuur:

json
{
  "error": "Validation Error",
  "message": "The email field is required.",
  "status_code": 422
}

Foutcodes

StatuscodeFoutOorzaak & oplossing
400 Bad Request Ongeldige JSON of ontbrekende verplichte velden. Controleer je request body.
401 Unauthorized Ontbrekende of ongeldige API-sleutel. Controleer je Authorization -header.
402 Payment Required Onvoldoende credits. Koop extra credits of wacht tot de daglimiet wordt gereset.
422 Validation Error Het formaat van het e-mailadres is ongeldig. Controleer de waarde die je verstuurt.
429 Too Many Requests Rate limit overschreden. Controleer de Retry-After -header en wacht even.
500 Internal Server Error Er ging aan onze kant iets mis. Probeer het over een paar seconden opnieuw. Neem contact op met support als het blijft mislukken.

401 Unauthorized

json
{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}

Oplossing: Controleer of je Authorization -header correct is opgemaakt als Bearer YOUR_API_KEY. Controleer je sleutel in het dashboard.

422 Validation Error

json
{
  "error": "Validation Error",
  "message": "The email field must be a valid email address.",
  "status_code": 422
}

Oplossing: Zorg dat de e-mailwaarde een geldig e-mailformaat heeft (bijv. user@example.com). Schoon je input op voordat je hem verstuurt.

429 Too Many Requests

json
{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please slow down.",
  "status_code": 429,
  "retry_after": 15
}

Oplossing: Wacht het aantal seconden uit retry_after voordat je het opnieuw probeert. Zie Rate limits →

Checklist voor probleemoplossing