Foutafhandeling en veelvoorkomende API-foutcodes

Wat als een API-call mislukt?

Goede foutafhandeling is net zo belangrijk als het maken van de juiste calls. De Leafy Energy API gebruikt standaard HTTP-statuscodes plus een eigen foutstructuur in JSON.

Veelvoorkomende codes

• 400 Bad Request – request is ongeldig (missende parameter, verkeerde waarde).
• 401 Unauthorized – API-key mist of is ongeldig.
• 403 Forbidden – key heeft geen toegang tot deze resource.
• 404 Not Found – resource bestaat niet (meer) of hoort niet bij deze klant.
• 429 Too Many Requests – rate limit overschreden.

Voorbeeld foutrespons

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry later.",
    "retry_after_seconds": 30
  }
}

In trainingsscenario's kun je deelnemers bewust fouten laten genereren om te oefenen met robuuste foutafhandeling.