Kann ich die API ohne Schlüssel nutzen?

Ja, alle Daten-Endpoints (Annoncen, Unternehmen, Personen, Verzeichnis, Statistiken) sind ohne Schlüssel offen. Der Schlüssel wird nur für die dokumentierten Pro- und Enterprise-Endpoints benötigt.

Wie übergebe ich meinen API-Schlüssel?

Header X-API-Key mit dem Wert sk_bodacc_... oder Authorization mit Bearer sk_bodacc_... Ein ungültiger oder widerrufener Schlüssel gibt 401 zurück.

Was tun bei einer 429-Antwort?

Beachten Sie den Retry-After-Header der Antwort, bevor Sie es erneut versuchen. Das Kontingent beträgt 60 Anfragen pro Minute und IP ohne Schlüssel (600 mit Schlüssel), plus 10 000 Anfragen pro Tag ohne Schlüssel (100 000 mit Schlüssel).

Warum ist die Paginierung begrenzt?

Um einen vollständigen Datenbank-Dump zu verhindern: limit ist auf 500 begrenzt, offset auf 10 000, und das Verzeichnis auf 200 Seiten à 100. Iterieren Sie über offset, um die Ergebnisse zu durchlaufen.

API BODACC : Authentifizierung und Grenzen : BODACC.io

Kostenloser öffentlicher Zugang

Die BODACC-API ist ohne Schlüssel auf allen Datenendpunkten geöffnet: Anzeigen, Unternehmen, Personen, Verzeichnis, Statistiken. Sie können die öffentlichen Daten sofort abfragen:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"

Einen API : Schlüssel erhalten

Die Angebote Pro und Enterprise stellen API-Schlüssel (Präfix sk_bodacc_) in Ihrem Bereich Mein Konto → API (/{locale}/mon-compte/api) bereit. Der Schlüssel entsperrt den Zugang zu den dokumentierten Endpunkten, die ihn erfordern.

Den Schlüssel übergeben

Zwei akzeptierte Header:

# X-API-Key-Header
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "X-API-Key: sk_bodacc_..."

# Oder Authorization Bearer
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "Authorization: Bearer sk_bodacc_..."

Ein ungültiger oder widerrufener Schlüssel gibt 401 mit einem expliziten JSON-Text zurück. Das Fehlen eines Schlüssels lässt den öffentlichen Zugang offen (kein Fehler).

Fehlercodes

Code	Bedeutung
`400`	Ungültiger Parameter (z. B. unbekannte Verzeichnisrolle)
`401`	Ungültiger oder widerrufener API-Schlüssel
`404`	Ressource nicht gefunden (Anzeige, SIREN, Person)
`429`	Zu viele Anfragen oder Kontingent überschritten — beachten Sie `Retry-After`

Grenzen und bewährte Praktiken

Rate-Limit : 60 Anfragen/Minute pro IP ohne Schlüssel, 600 mit einem gültigen Schlüssel
Tageskontingent : 10 000 Anfragen/Tag pro IP ohne Schlüssel, 100 000 mit Schlüssel — es blockiert die systematische Iteration der Filter (vollständiger Dump der Datenbank) ; der Zähler wird täglich zurückgesetzt
Anti-Dump-Grenzen : limit ≤ 500, offset ≤ 10 000 bei Anzeigen/Unternehmen/Kanzleien ; Verzeichnis und Akteure auf 200 Seiten à 100 begrenzt
Systematische Paginierung : iterieren Sie über offset (oder page/per_page für das Verzeichnis), anstatt große Mengen anzufragen
Retry-After : bei 429 warten Sie die angegebene Dauer ab, bevor Sie es erneut versuchen
Summen : bevorzugen Sie stats/counts und stats/daily (materialisiert) gegenüber COUNT(*) für Dashboards
Echtzeitdaten : die Daten werden nach jeder Veröffentlichung des BODACC aktualisiert
Cache : häufige Suchanfragen werden über den Cloudflare-Edge-Cache (300s) bedient — Ihre wiederholten Anfragen zählen nicht zum Kontingent

Weiterführendes

Schnellstart : erster Aufruf
Anzeigen suchen : Suchparameter
Statistiken : Zähler und Serien

API BODACC : Authentifizierung und Grenzen