Czy mogę używać API bez klucza?

Tak, wszystkie endpointy danych (ogłoszenia, firmy, osoby, katalog, statystyki) są otwarte bez klucza. Klucz jest wymagany tylko dla endpointów Pro i Enterprise opisanych w dokumentacji.

Jak przekazać mój klucz API?

Nagłówek X-API-Key z wartością sk_bodacc_... lub Authorization z Bearer sk_bodacc_... Nieprawidłowy lub cofnięty klucz zwraca błąd 401.

Co zrobić w przypadku błędu 429?

Przestrzegaj nagłówka Retry-After z odpowiedzi przed ponowną próbą. Limit to 60 zapytań na minutę na IP bez klucza (600 z kluczem) oraz 10 000 zapytań dziennie bez klucza (100 000 z kluczem).

Dlaczego paginacja jest ograniczona?

Aby zapobiec pełnemu zrzutowi bazy danych: limit jest maksymalnie 500, offset 10 000, a katalog do 200 stron po 100. Iteruj po offset, aby przeglądać wyniki.

Klucz API BODACC : uwierzytelnianie i limity : BODACC.io

Darmowy dostęp publiczny

API BODACC jest otwarte bez klucza na wszystkich endpointach danych: ogłoszenia, przedsiębiorstwa, osoby, katalog, statystyki. Możesz natychmiast przeszukiwać dane publiczne:

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

Uzyskanie klucza API

Oferty Pro i Enterprise zapewniają klucze API (prefiks sk_bodacc_) w Twoim panelu Moje konto → API (/{locale}/mon-compte/api). Klucz odblokowuje dostęp do udokumentowanych endpointów, które go wymagają.

Przekazywanie klucza

Akceptowane są dwa nagłówki:

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

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

Nieprawidłowy lub unieważniony klucz zwraca 401 z jednoznacznym ciałem JSON. Brak klucza pozostawia otwarty dostęp publiczny (bez błędu).

Kody błędów

Kod	Znaczenie
`400`	Nieprawidłowy parametr (np. nieznana rola w katalogu)
`401`	Nieprawidłowy lub unieważniony klucz API
`404`	Nie znaleziono zasobu (ogłoszenie, SIREN, osoba)
`429`	Zbyt wiele żądań lub przekroczony limit — przestrzegaj `Retry-After`

Limity i dobre praktyki

Rate limit: 60 żądań/minutę na IP bez klucza, 600 z ważnym kluczem
Limit dzienny: 10 000 żądań/dzień na IP bez klucza, 100 000 z kluczem — blokuje systematyczną iterację filtrów (pełny dump bazy); licznik resetuje się codziennie
Ograniczenia anty-dump: limit ≤ 500, offset ≤ 10 000 dla ogłoszeń/przedsiębiorstw/kancelarii; katalog i podmioty ograniczone do 200 stron po 100
Systematyczna paginacja: iteruj po offset (lub page/per_page dla katalogu) zamiast żądać dużych wolumenów
Retry-After: przy 429 poczekaj wskazany czas przed ponowną próbą
Sumy: preferuj stats/counts i stats/daily (zmaterializowane) zamiast COUNT(*) dla pulpitów nawigacyjnych
Dane w czasie rzeczywistym: dane są odświeżane po każdej publikacji BODACC
Cache: typowe wyszukiwania są obsługiwane przez cache brzegowy Cloudflare (300s) — Twoje powtarzane żądania nie wliczają się do limitu

Idź dalej

Szybki start: pierwsze wywołanie
Wyszukiwanie ogłoszeń: parametry wyszukiwania
Statystyki: liczniki i serie

Klucz API BODACC : uwierzytelnianie i limity