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 שניות) — בקשות חוזרות שלכם אינן נספרות במכסה
המשך קריאה
- התחלה מהירה : קריאה ראשונה
- חיפוש הודעות : פרמטרי חיפוש
- סטטיסטיקות : מונים וסדרות