דילוג לתוכן

Bot Protection

מרחיקה בוטים מהטפסים, מההתחברויות ומהאתרים המאוחסנים שלכם.

פתיחת Bot Protection
נבדק מול לוח הבקרה ב-18 בנובמבר 2026

ל-Bot Protection יש שני צדדים בקוד. בדף שלכם, סקריפט קטן מצייר את הבדיקה ושם טוקן בטופס שלכם כשמבקר עובר. בשרת שלכם, בקשה אחת מאשרת את הטוקן הזה עם מפתח הסוד של ההגדרה. אף אחד מהם לא צריך מפתח API של חשבון: מפתח האתר (ציבורי) ומפתח הסוד (פרטי) של ההגדרה עצמה הם מה שמגדיר את התחום שלהם.

ההגדרות עצמן, התוכניות שלהן והמספרים שלהן מנוהלים בדשבורד.

בדף שלכם

מעתיקים את קוד ההטמעה מההגדרה; הוא כבר מכיל את מפתח האתר של ההגדרה. זו הצורה שלו לכל אופן תצוגה של הבדיקה.

<script src="https://xuda.ai/dist/runtime/js/captcha-loader.js" async data-sitekey="YOUR_SITE_KEY"></script>
<div class="xuda-captcha" data-sitekey="YOUR_SITE_KEY"></div>
<script src="https://xuda.ai/dist/runtime/js/captcha-loader.js" async data-sitekey="YOUR_SITE_KEY"></script>
<div class="xuda-captcha" data-sitekey="YOUR_SITE_KEY" data-mode="invisible"></div>
<script src="https://xuda.ai/dist/runtime/js/captcha-loader.js" data-sitekey="YOUR_SITE_KEY" data-mode="fullpage"></script>
  • תיבת סימון ובלתי נראה: שמים את ה-div בתוך הטופס שרוצים להגן עליו. כשמבקר עובר, הסקריפט ממלא שדה נסתר בשם xuda-captcha-response באותו טופס, כך שהטוקן נשלח איתו.
  • בלתי נראה לא מציג כלום. טופס שנשלח בלי טוקן טרי נעצר, הבדיקה רצה, והטופס נשלח שוב.
  • עמוד מלא הוא הסקריפט לבדו, ב-head של העמוד. העמוד מכוסה עד שהמבקר עובר, והלשונית הזו לא נשאלת שוב עד שהמעבר שלה פג.
  • הגדרה שהמראה שלה בהיר או כהה מוסיפה data-theme="light" או data-theme="dark".

הבדיקה רצה רק בדומיינים המורשים של ההגדרה.

פונקציות callback

נותנים שם של פונקציה גלובלית על ה-div (או על הסקריפט, בעמוד מלא) כדי לקבל הודעה על מה שקרה:

window.xudaCaptcha.execute(element) מחזירה promise לטוקן טרי, לטופס שאתם שולחים מהקוד שלכם.

בשרת שלכם

שולחים את הטוקן ואת מפתח הסוד של ההגדרה ל-captcha_siteverify. מקבלים את הטופס רק כשהתשובה אומרת success. שומרים את מפתח הסוד בהגדרות של השרת שלכם, אף פעם לא בדף.

curl -s https://xuda.ai/cpi/captcha_siteverify \
  -H 'content-type: application/json' \
  -d '{"secret":"YOUR_SECRET_KEY","response":"TOKEN_FROM_THE_FORM"}'
const res = await fetch('https://xuda.ai/cpi/captcha_siteverify', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ secret: 'YOUR_SECRET_KEY', response: token }),
});
const { data } = await res.json();
if (!data.success) throw new Error('The check did not pass');
import requests

res = requests.post(
    'https://xuda.ai/cpi/captcha_siteverify',
    json={'secret': 'YOUR_SECRET_KEY', 'response': token},
)
passed = res.json()['data']['success']

מעבר מוצלח עונה:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
טוקן טוב פעם אחת, לשתי דקות

טוקן מתקבל פעם אחת בלבד וחי שתי דקות. מאשרים אותו כשהטופס מגיע, לא מאוחר יותר, ואף פעם לא מאשרים את אותו טוקן פעמיים.

כשהמעבר לא מצליח

success הוא false ו-error-codes אומר למה:

לתשובה אותה צורה כמו התשובות ש-reCAPTCHA ו-Turnstile נותנות, ולכן קוד שרת שנכתב עבורן בדרך כלל צריך רק שינוי של הכתובת ושל הסוד.

מגבלות התוכנית

בדיקה נספרת כשהשלב הראשון של מבקר מגיע להחלטה. המגבלה החודשית של התוכנית קוראת את הבדיקות באתרים ובטפסים שלכם; שום דבר שמתארח ב-Xuda לא נספר. מעבר למגבלה שלב ה-AI מדולג עד החודש הבא וכל בדיקה ממשיכה לרוץ, כך שאף טופס לא נשבר. ראו תוכניות וחיוב.

איך המדריך הזה?

עודכן לאחרונה ב-16 בנובמבר 2026