Kan ik de API zonder sleutel gebruiken?

Ja, alle data-endpoints (aankondigingen, bedrijven, personen, gids, statistieken) zijn open zonder sleutel. De sleutel is alleen nodig voor de gedocumenteerde Pro- en Enterprise-endpoints.

Hoe geef ik mijn API-sleutel door?

X-API-Key-header met de waarde sk_bodacc_..., of Authorization met Bearer sk_bodacc_... Een ongeldige of ingetrokken sleutel retourneert 401.

Wat te doen bij een 429-fout?

Respecteer de Retry-After-header van het antwoord voordat u het opnieuw probeert. Het quotum is 60 verzoeken per minuut per IP zonder sleutel (600 met sleutel), plus 10 000 verzoeken per dag zonder sleutel (100 000 met sleutel).

Waarom is de paginering beperkt?

Om volledige dumping van de database te voorkomen: limit is gemaximeerd op 500, offset op 10 000, en de gids op 200 pagina's van 100. Itereer over offset om resultaten te doorlopen.

API-sleutel BODACC : authenticatie en limieten : BODACC.io

Gratis openbare toegang

De BODACC-API is zonder sleutel toegankelijk op alle data-endpoints: advertenties, bedrijven, personen, bedrijvengids, statistieken. U kunt de openbare gegevens onmiddellijk raadplegen:

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

Een API : sleutel verkrijgen

De Pro- en Enterprise-aanbiedingen leveren API-sleutels (voorvoegsel sk_bodacc_) vanuit uw ruimte Mijn account → API (/{locale}/mon-compte/api). De sleutel ontgrendelt de toegang tot de gedocumenteerde endpoints die deze vereisen.

De sleutel doorgeven

Twee geaccepteerde headers:

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

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

Een ongeldige of ingetrokken sleutel retourneert 401 met een duidelijke JSON-body. Het ontbreken van een sleutel laat de openbare toegang open (geen foutmelding).

Foutcodes

Code	Betekenis
`400`	Ongeldige parameter (bijv. onbekende gidsrol)
`401`	Ongeldige of ingetrokken API-sleutel
`404`	Bron niet gevonden (advertentie, SIREN, persoon)
`429`	Te veel verzoeken of quotum overschreden — respecteer `Retry-After`

Limieten en goede praktijken

Rate limit : 60 verzoeken/minuut per IP zonder sleutel, 600 met een geldige sleutel
Dagelijks quotum : 10.000 verzoeken/dag per IP zonder sleutel, 100.000 met sleutel — dit blokkeert de systematische iteratie van filters (volledige dump van de database) ; de teller wordt elke dag gereset
Anti-dump-grenzen : limit ≤ 500, offset ≤ 10.000 op advertenties/bedrijven/kantoren ; bedrijvengids en acteurs begrensd tot 200 pagina's van 100
Systematische paginering : itereer over offset (of page/per_page voor de bedrijvengids) in plaats van grote volumes op te vragen
Retry-After : bij 429, wacht de aangegeven duur voordat u het opnieuw probeert
Totalen : geef de voorkeur aan stats/counts en stats/daily (gematerialiseerd) boven COUNT(*) voor dashboards
Realtime gegevens : de gegevens worden ververst na elke publicatie van het BODACC
Cache : veelvoorkomende zoekopdrachten worden bediend vanuit de Cloudflare-edge-cache (300s) — uw herhaalde verzoeken tellen niet mee voor het quotum

Verder gaan

Snelstart : eerste aanroep
Advertenties zoeken : zoekparameters
Statistieken : tellers en reeksen

API-sleutel BODACC : authenticatie en limieten