Bisakah saya menggunakan API tanpa kunci?

Ya, semua endpoint data (pengumuman, perusahaan, orang, direktori, statistik) terbuka tanpa kunci. Kunci hanya diperlukan untuk endpoint Pro dan Enterprise yang didokumentasikan.

Bagaimana cara mengirim kunci API saya?

Gunakan header X-API-Key dengan nilai sk_bodacc_..., atau Authorization dengan Bearer sk_bodacc_... Kunci yang tidak valid atau dicabut akan mengembalikan 401.

Apa yang harus dilakukan jika mendapat 429?

Patuhi header Retry-After dari respons sebelum mencoba lagi. Kuota adalah 60 permintaan per menit per IP tanpa kunci (600 dengan kunci), plus 10 000 permintaan per hari tanpa kunci (100 000 dengan kunci).

Mengapa pagination dibatasi?

Untuk mencegah dump lengkap database: limit dibatasi hingga 500, offset hingga 10 000, dan direktori hingga 200 halaman dari 100. Iterasi offset untuk menelusuri hasil.

Kunci API BODACC : autentikasi dan batasan : BODACC.io

Akses publik gratis

API BODACC terbuka tanpa kunci di semua endpoint data: pengumuman, perusahaan, orang, direktori, statistik. Anda dapat langsung mengakses data publik:

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

Mendapatkan kunci API

Penawaran Pro dan Enterprise menyediakan kunci API (awalan sk_bodacc_) dari akun Anda di Akun saya → API (/{locale}/mon-compte/api). Kunci ini membuka akses ke endpoint terdokumentasi yang memerlukannya.

Mengirimkan kunci

Dua header yang diterima:

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

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

Kunci yang tidak valid atau dicabut akan mengembalikan 401 dengan badan JSON yang jelas. Tidak adanya kunci membiarkan akses publik tetap terbuka (tanpa kesalahan).

Kode kesalahan

Kode	Arti
`400`	Parameter tidak valid (mis. peran direktori tidak dikenal)
`401`	Kunci API tidak valid atau dicabut
`404`	Sumber daya tidak ditemukan (pengumuman, SIREN, orang)
`429`	Terlalu banyak permintaan atau kuota terlampaui — patuhi `Retry-After`

Batasan dan praktik terbaik

Rate limit : 60 permintaan/menit per IP tanpa kunci, 600 dengan kunci valid
Kuota harian : 10.000 permintaan/hari per IP tanpa kunci, 100.000 dengan kunci — ini memblokir iterasi sistematis filter (dump lengkap basis data); penghitung direset setiap hari
Batas anti-dump : limit ≤ 500, offset ≤ 10.000 pada pengumuman/perusahaan/kantor; direktori dan aktor dibatasi hingga 200 halaman berisi 100
Paginasi sistematis : lakukan iterasi pada offset (atau page/per_page untuk direktori) alih-alih meminta volume besar
Retry-After : pada 429, tunggu durasi yang ditunjukkan sebelum mencoba lagi
Total : gunakan stats/counts dan stats/daily (terwujud) daripada COUNT(*) untuk dasbor
Data waktu nyata : data diperbarui setelah setiap penerbitan BODACC
Cache : pencarian umum dilayani oleh cache edge Cloudflare (300 detik) — permintaan berulang Anda tidak dihitung dalam kuota

Melangkah lebih jauh

Mulai cepat : panggilan pertama
Mencari pengumuman : parameter pencarian
Statistik : penghitung dan rangkaian data

Kunci API BODACC : autentikasi dan batasan