Preskočiť na obsah

Bot Protection

Drží boty mimo vašich formulárov, prihlásení a hostovaných webov.

Otvoriť Bot Protection
Overené voči nástenke dňa 18. novembra 2026

Bot Protection má v kóde dve strany. Na vašej stránke malý skript nakreslí kontrolu a po prechode návštevníka vloží do formulára token. Na vašom serveri jedna požiadavka potvrdí tento token pomocou tajného kľúča nastavenia. Ani jedno nepotrebuje API kľúč účtu: ohraničujú ich vlastný kľúč stránky (verejný) a tajný kľúč (súkromný) nastavenia.

Samotné nastavenia, ich plány a ich čísla sa spravujú v dashboarde.

Na vašej stránke

Skopírujte kód na vloženie z nastavenia; už obsahuje kľúč stránky nastavenia. Takto vyzerá pre každý spôsob zobrazenia kontroly.

<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>
  • Začiarkavacie pole a Neviditeľne: vložte div do formulára, ktorý chcete chrániť. Po prechode skript vyplní skryté pole s názvom xuda-captcha-response v tomto formulári, takže sa token odošle spolu s ním.
  • Neviditeľne nezobrazí nič. Formulár odoslaný bez čerstvého tokenu sa zadrží, kontrola sa spustí a formulár sa odošle znova.
  • Celá stránka je samotný skript v hlavičke (head) stránky. Stránka je zakrytá, kým návštevník neprejde, a táto karta sa znova nepýta, kým jej prechod nevyprší.
  • Nastavenie s vzhľadom Light alebo Dark pridá data-theme="light" alebo data-theme="dark".

Kontrola beží len na povolených doménach nastavenia.

Spätné volania

Pomenujte globálnu funkciu na div (alebo na skripte, pri režime Celá stránka), aby ste sa dozvedeli, čo sa stalo:

window.xudaCaptcha.execute(element) vráti promise s čerstvým tokenom, pre formulár, ktorý odosielate z vlastného kódu.

Na vašom serveri

Odošlite token a tajný kľúč nastavenia na captcha_siteverify. Formulár prijmite, len keď odpoveď hovorí success. Tajný kľúč majte vo vlastnej konfigurácii servera, nikdy na stránke.

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

Úspešný prechod odpovie:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Token platí raz a dve minúty

Token sa prijme iba raz a žije dve minúty. Potvrďte ho, keď formulár dorazí, nie neskôr, a nikdy ten istý token nepotvrdzujte dvakrát.

Keď neprejde

success je false a error-codes hovorí prečo:

Odpoveď má rovnaký tvar ako tie, ktoré dávajú reCAPTCHA a Turnstile, takže serverový kód napísaný pre ne zvyčajne potrebuje zmeniť iba adresu a tajný kľúč.

Limity plánu

Kontrola sa počíta, keď prvý krok návštevníka dospeje k rozhodnutiu. Mesačný limit plánu číta kontroly na vašich vlastných stránkach a formulároch; všetko hostované cez Xuda sa nepočíta. Po prekročení limitu sa krok AI do budúceho mesiaca preskočí a každá kontrola naďalej beží, takže sa nepokazí žiadny formulár. Pozrite Plány a fakturácia.

Aký je tento návod?

Naposledy aktualizované dňa 20. novembra 2026