API'siz kullanabilir miyim?

Evet, tüm veri uç noktaları (ilanlar, şirketler, kişiler, rehber, istatistikler) anahtar olmadan açıktır. Anahtar yalnızca belgelenen Pro ve Enterprise uç noktaları için gereklidir.

API anahtarımı nasıl iletirim?

X-API-Key başlığında sk_bodacc_... değeri veya Authorization başlığında Bearer sk_bodacc_... kullanın. Geçersiz veya iptal edilmiş bir anahtar 401 döndürür.

429 hatası alırsam ne yapmalıyım?

Tekrar denemeden önce yanıttaki Retry-After başlığına uyun. Kota, anahtar olmadan IP başına dakikada 60 istek (anahtarla 600) ve anahtar olmadan günde 10 000 istek (anahtarla 100 000) şeklindedir.

Sayfalama neden sınırlı?

Veritabanının tamamen kopyalanmasını önlemek için: limit en fazla 500, offset en fazla 10 000 ve rehber 100'er sayfalık 200 sayfa ile sınırlıdır. Sonuçları taramak için offset üzerinde ilerleyin.

API anahtarı BODACC : Kimlik Doğrulama ve Sınırlar : BODACC…

Ücretsiz Genel Erişim

BODACC API, tüm veri uç noktalarında anahtar olmadan açıktır: ilanlar, şirketler, kişiler, rehber, istatistikler. Genel verileri hemen sorgulayabilirsiniz:

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

API Anahtarı Alma

Pro ve Enterprise paketleri, Hesabım → API bölümünden (/{locale}/mon-compte/api) API anahtarları (sk_bodacc_ öneki) sağlar. Anahtar, bunu gerektiren belgelenmiş uç noktalara erişimi açar.

Anahtarı İletme

İki kabul edilen başlık:

# X-API-Key başlığı
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "X-API-Key: sk_bodacc_..."

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

Geçersiz veya iptal edilmiş bir anahtar, açıklayıcı bir JSON gövdesiyle 401 döndürür. Anahtarın olmaması genel erişimi açık bırakır (hata yok).

Hata Kodları

Kod	Anlam
`400`	Geçersiz parametre (örn. bilinmeyen rehber rolü)
`401`	Geçersiz veya iptal edilmiş API anahtarı
`404`	Kaynak bulunamadı (ilan, SIREN, kişi)
`429`	Çok fazla istek veya kota aşıldı — `Retry-After` başlığına uyun

Sınırlar ve En İyi Uygulamalar

Hız sınırı : Anahtarsız IP başına dakikada 60 istek, geçerli anahtarla 600
Günlük kota : Anahtarsız IP başına günde 10.000 istek, anahtarla 100.000 — filtrelerin sistematik olarak taranmasını (veritabanının tamamen boşaltılmasını) engeller; sayaç her gün sıfırlanır
Anti-dump sınırları : İlanlar/şirketler/ofisler için limit ≤ 500, offset ≤ 10.000; rehber ve aktörler 100'er sayfalık 200 sayfayla sınırlıdır
Sistematik sayfalama : Büyük hacimler istemek yerine offset (veya rehber için page/per_page) üzerinde ilerleyin
Retry-After : 429 durumunda, yeniden denemeden önce belirtilen süreyi bekleyin
Toplamlar : Panolar için COUNT(*) yerine (somutlaştırılmış) stats/counts ve stats/daily kullanmayı tercih edin
Gerçek zamanlı veriler : Veriler, BODACC'in her yayınından sonra yenilenir
Önbellek : Sık yapılan aramalar Cloudflare uç önbelleği (300s) tarafından sunulur — tekrarlanan istekleriniz kotaya dahil edilmez

Daha Fazla Bilgi

Hızlı Başlangıç : ilk çağrı
İlan Arama : arama parametreleri
İstatistikler : sayaçlar ve seriler

API anahtarı BODACC : Kimlik Doğrulama ve Sınırlar