Accueil›Documentation

مفتاح API BODACC : المصادقة والحدود

الوصول العام المجاني

API BODACC مفتوح بدون مفتاح على جميع نقاط نهاية البيانات: الإعلانات، الشركات، الأشخاص، الدليل، الإحصائيات. يمكنك الاستعلام عن البيانات العامة فورًا:

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_..."

مفتاح غير صالح أو ملغى يُرجع 401 مع نص JSON واضح. غياب المفتاح يترك الوصول العام مفتوحًا (بدون أي خطأ).

رموز الأخطاء

الرمزالمعنى
400معلمة غير صالحة (مثل دور دليل غير معروف)
401مفتاح API غير صالح أو ملغى
404المورد غير موجود (إعلان، SIREN، شخص)
429عدد كبير جدًا من الطلبات أو تجاوز الحصة — احترم Retry-After

الحدود والممارسات الجيدة

  • حد المعدل: 60 طلبًا/دقيقة لكل عنوان IP بدون مفتاح، 600 مع مفتاح صالح
  • الحصة اليومية: 10,000 طلب/يوم لكل عنوان IP بدون مفتاح، 100,000 مع مفتاح — يمنع التكرار المنهجي للفلاتر (تفريغ كامل لقاعدة البيانات)؛ يُعاد ضبط العداد كل يوم
  • حدود منع التفريغ: limit ≤ 500، offset ≤ 10,000 على الإعلانات/الشركات/المكاتب؛ الدليل والفاعلون محدودون بـ 200 صفحة من 100
  • ترقيم الصفحات المنهجي: كرر على offset (أو page/per_page للدليل) بدلاً من طلب كميات كبيرة
  • Retry-After: عند 429، انتظر المدة المحددة قبل إعادة المحاولة
  • الإجماليات: فضل stats/counts وstats/daily (المادية) على COUNT(*) للوحات المعلومات
  • البيانات في الوقت الفعلي: تُحدَّث البيانات بعد كل إصدار من BODACC
  • التخزين المؤقت: تُقدَّم عمليات البحث الشائعة من خلال ذاكرة التخزين المؤقت الطرفية لـ Cloudflare (300 ثانية) — طلباتك المتكررة لا تُحتسب ضمن الحصة

المزيد

FAQ

لديك سؤال؟

فريقنا يرد عليك بسرعة. سيتم إرسال طلبك مع فئة API.