Accueil›Documentation

بدء سريع مع API BODACC

البيانات المفتوحة والمجانية

واجهة برمجة تطبيقات BODACC مجانية ومفتوحة: توفر وصولاً إلى البيانات المفتوحة وفي الوقت الفعلي لقاعدة البيانات الكاملة للجريدة الرسمية — 11.3 مليون إعلان، 6.7 مليون شركة، 1.9 مليون شخص (أرقام مباشرة stats/counts). بينما يُنزَّل ملف BODACC التاريخي مرة واحدة يومياً، تعرض الواجهة الإعلانات فور نشرها، دون مفتاح للبيانات العامة.

# العدادات الدقيقة، دون مفتاح
curl "https://bodacc.io/api/bodacc/stats/counts"

أول استدعاء

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

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

الرد (مقتطف):

{
  "total": 48231,
  "results": [
    {
      "id": "A2023001_000123",
      "dateparution": "2026-08-07",
      "typeavis": "A",
      "familleavis": "creation",
      "commercant": "BOULANGERIE DUPONT",
      "ville": "LYON",
      "numerodepartement": "69"
    }
  ],
  "limit": 5,
  "offset": 0
}

المواصفات الكاملة

توثق الواجهة 46 نقطة نهاية (تم التحقق منها على OpenAPI المباشر). طريقتان لاستكشافها:

  • Swagger UI: https://bodacc.io/api/bodacc/docs
  • https://bodacc.io/api/bodacc/openapi.json

نقاط النهاية الرئيسية

نقطة النهايةالوصف
GET /api/bodacc/annoncesالبحث عن الإعلانات (كلمة مفتاحية، عائلة، مدينة، إدارة، SIREN، تواريخ)
GET /api/bodacc/annonces/{id}تفاصيل إعلان + العلاقات (شركة، أشخاص)
GET /api/bodacc/entreprisesالبحث عن الشركات (الاسم، SIREN، NAF، الحالة، فلاتر موسعة)
GET /api/bodacc/entreprises/{siren}بطاقة كاملة لرقم SIREN
GET /api/bodacc/personnes/{id}بطاقة شخص (الهوية + المهام)
GET /api/bodacc/annuaire/{role}دليل المصفيين والوكلاء والمسؤولين
GET /api/bodacc/stats/countsعدادات عامة (إعلانات، شركات، أشخاص)

المصادقة

الوصول العام لا يتطلب أي مفتاح. بالنسبة لعروض Pro وEnterprise، تقبل نقاط النهاية الموثقة مفتاح API:

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

يمكن تمرير المفتاح أيضاً عبر Authorization: Bearer sk_bodacc_.... المفتاح غير الصالح أو الملغى يُرجع 401.

الأخطاء

تُرجع الواجهة أخطاء HTTP قياسية مع جسم JSON يوضح المشكلة:

  • 400: معلمة غير صالحة
  • 401: مفتاح API غير صالح أو ملغى
  • 404: المورد غير موجود
  • 429: عدد كبير جداً من الطلبات — احترم الترويسة Retry-After

الحدود

  • limit: بين 1 و500 لكل طلب
  • offset: حتى 10,000 (ترقيم صفحات مضاد للتفريغ)
  • يتم تحديث البيانات في الوقت الفعلي بعد كل نشر لـ BODACC
  • البحث حسب العائلة يستخدم إجماليات دقيقة مادية (بدون total_estime)؛ قد تُرجع عمليات البحث النصية المجمعة إجمالياً تقديرياً ("total_estime": true)

المزيد

FAQ

لديك سؤال؟

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