Přeskočit na obsah

Bot Protection

Drží boty mimo vaše formuláře, přihlášení a hostované weby.

Otevřít Bot Protection
Ověřeno podle nástěnky dne 18. listopadu 2026

Bot Protection má v kódu dvě strany. Na vaší stránce malý skript vykreslí kontrolu a po průchodu návštěvníka vloží do vašeho formuláře token. Na vašem serveru jeden požadavek potvrdí tento token pomocí tajného klíče nastavení. Ani jedno nepotřebuje klíč API účtu: vymezují je vlastní klíč webu (veřejný) a tajný klíč (soukromý) nastavení.

Samotná nastavení, jejich tarify a jejich čísla se spravují v dashboardu.

Na vaší stránce

Zkopírujte kód pro vložení z nastavení; už obsahuje klíč webu nastavení. Takto vypadá pro každý způsob zobrazení 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škrtávací pole a Neviditelně: vložte div dovnitř formuláře, který chcete chránit. Po průchodu skript vyplní v tomto formuláři skryté pole s názvem xuda-captcha-response, takže se token odešle spolu s ním.
  • Neviditelně nic nezobrazuje. Formulář odeslaný bez čerstvého tokenu se zadrží, kontrola proběhne a formulář se odešle znovu.
  • Celá stránka je samotný skript v hlavičce stránky. Stránka je zakryta, dokud návštěvník neprojde, a tentýž panel se znovu neptá, dokud jeho průchod nevyprší.
  • Nastavení, jehož vzhled je Světlý nebo Tmavý, přidá data-theme="light" nebo data-theme="dark".

Kontrola běží jen na povolených doménách nastavení.

Zpětná volání

Uveďte globální funkci na div (nebo na skriptu u Celé stránky), abyste se dozvěděli, co se stalo:

window.xudaCaptcha.execute(element) vrací promise čerstvého tokenu pro formulář, který odesíláte z vlastního kódu.

Na vašem serveru

Odešlete token a tajný klíč nastavení na captcha_siteverify. Formulář přijměte, jen když odpověď říká success. Tajný klíč držte v konfiguraci svého serveru, nikdy na stránce.

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

Průchod odpoví:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Token platí jednou, dvě minuty

Token se přijme jen jednou a žije dvě minuty. Potvrďte ho při příchodu formuláře, ne později, a nikdy nepotvrzujte tentýž token dvakrát.

Když neprojde

success je false a error-codes říká proč:

Odpověď má stejný tvar jako ty od reCAPTCHA a Turnstile, takže serverový kód psaný pro ně obvykle potřebuje změnit jen adresu a tajný klíč.

Limity tarifu

Kontrola se počítá, když první krok návštěvníka dospěje k rozhodnutí. Měsíční limit tarifu čte kontroly na vašich vlastních webech a formulářích; co je hostované u Xuda, se nepočítá. Po překročení limitu se krok AI do příštího měsíce přeskočí a každá kontrola běží dál, takže se žádný formulář nerozbije. Viz Tarify a fakturace.

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026