Fehler

API BCE verwendet übliche HTTP-Statuscodes. 2xx = Erfolg, 4xx = Problem mit Ihrer Anfrage, 5xx = Problem auf unserer Seite.

Statuscodes#

Typ	Beschreibung
`400`	Anfrage fehlerhaft oder ein erforderlicher Parameter fehlt.
`401`	Fehlende oder ungültige API-Zugangsdaten.
`402`	Abo inaktiv oder Monatskontingent erschöpft.
`403`	Ihr Schlüssel darf auf diese Ressource nicht zugreifen.
`404`	Die angeforderte Entität existiert nicht.
`412`	Eine erforderliche Vorbedingung (z. B. Header) wurde nicht erfüllt.
`429`	Stundenlimit oder Monatskontingent überschritten.
`500`	Auf unserer Seite ist ein Fehler aufgetreten. Später erneut versuchen.

Fehler nutzen dieselbe Envelope; die Meldung steht in error. Kontingent- und Ratenfehler ergänzen plan, limit und resetAt.

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

ℹ️

Wiederholen Sie 429- und 5xx-Antworten mit exponentiellem Backoff. Wiederholen Sie keine 4xx-Fehler außer 429.