Fehler

Fehler haben immer dieselbe Form:

{ "error": { "code": "not_found", "message": "Firma nicht gefunden" } }

Der code ist englisch und stabil, du kannst darauf programmieren. Die message ist deutsch und für Menschen gedacht.

Status	Code	Bedeutung	Kostet
400	`invalid_request`	Parameter oder Body ungültig	nichts
401	`unauthorized`	Schlüssel fehlt	nichts
401	`invalid_api_key`	Schlüssel ungültig oder gesperrt	nichts
402	`insufficient_credits`	Zu wenig Credits für diesen Aufruf	nichts
403	`account_blocked`	Konto gesperrt	nichts
403	`purchase_required`	Funktion setzt einen Kauf voraus (Webhooks)	nichts
404	`not_found`	Nicht gefunden, oder auf Wunsch der Betroffenen gesperrt	nichts
413	`payload_too_large`	Anfrage zu groß	nichts
415	`unsupported_media_type`	Content-Type nicht unterstützt	nichts
429	`rate_limited`	Ratenlimit überschritten, siehe `Retry-After`	nichts
500	`internal_error`	Unerwarteter Fehler auf unserer Seite	nichts
503	`not_configured`	Funktion auf diesem Server nicht eingerichtet	nichts
503	`temporarily_unavailable`	Schutzfunktion (z. B. Ratenbegrenzung) gerade nicht verfügbar, siehe `Retry-After`	nichts

Hinweise

Eine gesperrte Domain oder Firma (Opt-out, Widerspruch) liefert 404, genau wie eine unbekannte. Du kannst den Unterschied nicht erkennen, und er kostet nichts.
Wiederhole 429 und 5xx mit wachsendem Abstand; bei 429 nennt Retry-After die Wartezeit in Sekunden.
Wiederhole 4xx nie ungeändert.