Hopp til innholdet

Bot Protection

Holder roboter unna skjemaene, innloggingene og nettstedene dine.

Åpne Bot Protection
Kontrollert mot oversiktspanelet 18. november 2026

Bot Protection har to sider i kode. På siden din tegner et lite skript sjekken og legger et token i skjemaet når en besøkende kommer gjennom. På serveren din bekrefter én forespørsel tokenet med oppsettets hemmelige nøkkel. Ingen av delene trenger en API-nøkkel for kontoen: oppsettets egen nettstednøkkel (offentlig) og hemmelige nøkkel (privat) avgrenser dem.

Selve oppsettene, planene og tallene deres styres i dashbordet.

På siden din

Kopier innbyggingskoden fra oppsettet; den inneholder allerede oppsettets nettstednøkkel. Slik ser den ut for hver måte sjekken kan vises på.

<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>
  • Avkrysningsboks og Usynlig: legg div-en inni skjemaet du vil beskytte. Når en besøkende kommer gjennom, fyller skriptet et skjult felt som heter xuda-captcha-response i det skjemaet, så tokenet sendes med.
  • Usynlig viser ingenting. Et skjema som sendes uten ferskt token, holdes tilbake, sjekken kjører, og skjemaet sendes på nytt.
  • Hele siden er bare skriptet, i head på siden. Siden er dekket til besøkende kommer gjennom, og den fanen blir ikke spurt igjen før godkjenningen går ut.
  • Et oppsett med utseendet Lys eller Mørk legger til data-theme="light" eller data-theme="dark".

Sjekken kjører bare på oppsettets tillatte domener.

Callbacks

Gi en global funksjon navn på div-en (eller på skriptet, for Hele siden) for å få beskjed om hva som skjedde:

window.xudaCaptcha.execute(element) returnerer et løfte om et ferskt token, for et skjema du sender fra din egen kode.

På serveren din

Send tokenet og oppsettets hemmelige nøkkel til captcha_siteverify. Godta skjemaet bare når svaret sier success. Ha den hemmelige nøkkelen i serverens egen konfigurasjon, aldri på en side.

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

En godkjenning svarer:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Et token gjelder én gang, i to minutter

Et token godtas bare én gang og lever i to minutter. Bekreft det når skjemaet kommer inn, ikke senere, og bekreft aldri samme token to ganger.

Når den ikke kommer gjennom

success er false, og error-codes sier hvorfor:

Svaret har samme form som de reCAPTCHA og Turnstile gir, så serverkode skrevet for dem trenger vanligvis bare ny adresse og ny hemmelighet.

Plangrenser

En sjekk telles når en besøkendes første steg når en avgjørelse. Planens månedlige grense leser sjekkene på dine egne nettsteder og skjemaer; alt som er vert for hos Xuda, telles ikke. Over en grense hoppes AI-steget over til neste måned, og alle sjekker fortsetter å kjøre, så ingen skjemaer slutter å virke. Se Planer og fakturering.

Hvordan er denne veiledningen?

Sist oppdatert 19. november 2026