Sari la conținut

Bot Protection

Ține boții departe de formularele, autentificările și site-urile tale găzduite.

Deschide Bot Protection
Verificat față de tabloul de bord la 18 noiembrie 2026

Bot Protection are două părți în cod. Pe pagina ta, un script mic desenează verificarea și pune un token în formularul tău când un vizitator trece. Pe serverul tău, o singură cerere confirmă acel token cu cheia secretă a configurării. Niciuna nu cere o cheie API a contului: cheia de site (publică) și cheia secretă (privată) ale unei configurări sunt cele care le delimitează.

Configurările în sine, planurile și cifrele lor se gestionează în dashboard.

Pe pagina ta

Copiază codul de încorporare din configurare; conține deja cheia de site a configurării. Aceasta este forma lui pentru fiecare mod în care apare verificarea.

<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>
  • Casetă de bifare și Invizibil: pune div-ul în interiorul formularului pe care vrei să îl protejezi. La o trecere, scriptul completează în acel formular un câmp ascuns numit xuda-captcha-response, astfel încât tokenul este trimis odată cu el.
  • Invizibil nu arată nimic. Un formular trimis fără un token proaspăt este reținut, verificarea rulează, iar formularul se trimite din nou.
  • Pagină întreagă este doar scriptul, în head-ul paginii. Pagina rămâne acoperită până când vizitatorul trece, iar acel tab nu mai este întrebat până când trecerea expiră.
  • O configurare al cărei aspect este Light sau Dark adaugă data-theme="light" sau data-theme="dark".

Verificarea rulează doar pe domeniile permise ale configurării.

Callback-uri

Numește o funcție globală pe div (sau pe script, pentru Pagină întreagă) ca să fii anunțat ce s-a întâmplat:

window.xudaCaptcha.execute(element) returnează o promisiune a unui token proaspăt, pentru un formular pe care îl trimiți din propriul cod.

Pe serverul tău

Trimite tokenul și cheia secretă a configurării către captcha_siteverify. Acceptă formularul doar când răspunsul spune success. Păstrează cheia secretă în configurația proprie a serverului tău, niciodată într-o pagină.

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']

O trecere răspunde astfel:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Un token e valabil o singură dată, două minute

Un token este acceptat o singură dată și trăiește două minute. Confirmă-l când ajunge formularul, nu mai târziu, și nu confirma niciodată același token de două ori.

Când nu trece

success este false, iar error-codes spune de ce:

Răspunsul are aceeași formă ca cele date de reCAPTCHA și Turnstile, așa că pentru codul de server scris pentru acestea de obicei e nevoie doar să schimbi adresa și secretul.

Limitele planului

O verificare se numără când primul pas al unui vizitator ajunge la o decizie. Limita lunară a planului citește verificările de pe propriile tale site-uri și formulare; nu se numără nimic din ce este găzduit cu Xuda. După o limită, pasul AI este omis până luna viitoare, iar fiecare verificare continuă să ruleze, deci niciun formular nu se strică. Vezi Planuri și facturare.

Cum ți se pare acest ghid?

Ultima actualizare: 19 noiembrie 2026