Fouten

API BCE gebruikt conventionele HTTP-statuscodes. 2xx = succes, 4xx = probleem met je verzoek, 5xx = probleem aan onze kant.

Statuscodes#

Type	Omschrijving
`400`	Verzoek onjuist opgebouwd of een verplichte parameter ontbreekt.
`401`	Ontbrekende of ongeldige API-credentials.
`402`	Abonnement inactief of maandquota uitgeput.
`403`	Je sleutel mag deze resource niet benaderen.
`404`	De gevraagde entiteit bestaat niet.
`412`	Een vereiste preconditie (bv. headers) is niet voldaan.
`429`	Uurlimiet of maandquota overschreden.
`500`	Er ging iets mis aan onze kant. Probeer later opnieuw.

Fouten gebruiken dezelfde envelope; het bericht staat in error. Quota- en limietfouten voegen plan, limit en resetAt toe.

{
  "success": false,
  "error": "Monthly quota exceeded",
  "plan": "free",
  "limit": 1000,
  "resetAt": "2026-07-01T00:00:00.000Z"
}

ℹ️

Probeer 429- en 5xx-antwoorden opnieuw met exponentiële backoff. Herhaal geen 4xx-fouten behalve 429.