Foutafhandeling

Onze API gebruikt standaard HTTP-antwoordcodes om het succes of falen van aanvragen aan te geven. Hier zijn de veelvoorkomende foutcodes die u kunt tegenkomen en hoe u ermee omgaat.

HTTP-statuscodes
200 OK

De aanvraag is geslaagd.

400 Bad Request

De aanvraag was ongeldig of kan niet worden afgehandeld.

401 Unauthorized

Authenticatie is mislukt of werd niet verstrekt.

403 Forbidden

De aanvraag is begrepen, maar geweigerd of de toegang is niet toegestaan.

404 Not Found

De gevraagde bron kon niet worden gevonden.

429 Too Many Requests

U hebt de aanvraaglimiet overschreden.

500 Internal Server Error

Er is iets misgegaan aan onze kant.

Foutantwoordformaat
Alle foutantwoorden volgen dit formaat:
{
  "error": "error_code",
  "message": "Human-readable error message",
  "details": {}
}
Veelvoorkomende foutcodes

invalid_api_key: De opgegeven API-sleutel is ongeldig.

missing_api_key: Er werd geen API-sleutel opgegeven.

invalid_ip: Het opgegeven IP-adres is ongeldig.

invalid_domain: Het opgegeven domein is ongeldig.

rate_limit_exceeded: U hebt uw aanvraaglimiet overschreden.

quota_exceeded: U hebt uw maandelijkse quotum overschreden.

server_error: Er is een interne serverfout opgetreden.

Best practices voor foutafhandeling

Controleer statuscodes: Controleer altijd de HTTP-statuscode voordat u het antwoord verwerkt.

Verwerk aanvraaglimieten: Implementeer een passende backoff- en herhalingslogica voor 429-fouten.

Log fouten: Log gedetailleerde foutinformatie voor foutopsporing.

Gracieuze degradatie: Zorg voor terugvalmechanismen wanneer de API niet beschikbaar is.