Accueil›Documentation

API कुंजी BODACC : प्रमाणीकरण और सीमाएँ

निःशुल्क सार्वजनिक पहुंच

BODACC API बिना कुंजी के खुला है सभी डेटा एंडपॉइंट्स पर: विज्ञापन, कंपनियाँ, व्यक्ति, निर्देशिका, आँकड़े। आप सार्वजनिक डेटा तुरंत पूछताछ कर सकते हैं:

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

API कुंजी प्राप्त करना

Pro और Enterprise योजनाएँ API कुंजियाँ (उपसर्ग sk_bodacc_) प्रदान करती हैं, जो आपके मेरा खाता → API (/{locale}/mon-compte/api) अनुभाग से उपलब्ध हैं। यह कुंजी उन दस्तावेजित एंडपॉइंट्स तक पहुंच खोलती है जिन्हें इसकी आवश्यकता होती है।

कुंजी पास करना

दो स्वीकृत हेडर:

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

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

एक अमान्य या निरस्त कुंजी स्पष्ट JSON बॉडी के साथ 401 लौटाती है। कुंजी की अनुपस्थिति सार्वजनिक पहुंच खुली छोड़ देती है (कोई त्रुटि नहीं)।

त्रुटि कोड

कोडअर्थ
400अमान्य पैरामीटर (जैसे अज्ञात निर्देशिका भूमिका)
401अमान्य या निरस्त API कुंजी
404संसाधन नहीं मिला (विज्ञापन, SIREN, व्यक्ति)
429बहुत अधिक अनुरोध या कोटा समाप्त — Retry-After का पालन करें

सीमाएँ और सर्वोत्तम अभ्यास

  • रेट सीमा : बिना कुंजी के प्रति IP 60 अनुरोध/मिनट, मान्य कुंजी के साथ 600
  • दैनिक कोटा : बिना कुंजी के प्रति IP 10,000 अनुरोध/दिन, कुंजी के साथ 100,000 — यह फ़िल्टरों की व्यवस्थित पुनरावृत्ति (डेटाबेस का पूर्ण डंप) को रोकता है; काउंटर प्रतिदिन रीसेट होता है
  • एंटी-डंप सीमाएँ : विज्ञापनों/कंपनियों/कार्यालयों पर limit ≤ 500, offset ≤ 10,000; निर्देशिका और अभिनेता 100 की 200 पृष्ठों तक सीमित
  • व्यवस्थित पेजिनेशन : बड़े वॉल्यूम माँगने के बजाय offset (या निर्देशिका के लिए page/per_page) पर पुनरावृत्ति करें
  • Retry-After : 429 पर, पुनः प्रयास करने से पहले निर्दिष्ट अवधि प्रतीक्षा करें
  • कुल योग : डैशबोर्ड के लिए COUNT(*) के बजाय stats/counts और stats/daily (भौतिक) को प्राथमिकता दें
  • रीयल-टाइम डेटा : BODACC के प्रत्येक प्रकाशन के बाद डेटा ताज़ा किया जाता है
  • कैश : सामान्य खोजें Cloudflare एज कैश (300 सेकंड) द्वारा परोसी जाती हैं — आपके दोहराए गए अनुरोध कोटा में नहीं गिने जाते

आगे बढ़ें

FAQ

कोई सवाल?

हमारी टीम आपको जल्दी जवाब देगी। आपकी पूछताछ API श्रेणी के साथ भेजी जाएगी।