Gå til indhold

Bot Protection

Holder bots væk fra dine formularer, logins og hostede hjemmesider.

Åbn Bot Protection
Kontrolleret mod dashboardet den 18. november 2026

Bot Protection har to sider i kode. På din side tegner et lille script tjekket og lægger et token i din formular, når en besøgende består. På din server bekræfter én anmodning det token med opsætningens hemmelige nøgle. Ingen af dem kræver en API-nøgle til kontoen: en opsætnings egen sidenøgle (offentlig) og hemmelige nøgle (privat) afgrænser dem.

Selve opsætningerne, deres planer og deres tal styres i dashboardet.

På din side

Kopiér indlejringskoden fra opsætningen. Den indeholder allerede opsætningens sidenøgle. Sådan ser den ud for hver måde, tjekket 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>
  • Afkrydsningsfelt og Usynlig: sæt div inde i den formular, du vil beskytte. Når en besøgende består, udfylder scriptet et skjult felt med navnet xuda-captcha-response i den formular, så tokenet sendes med.
  • Usynlig viser intet. En formular, der sendes uden et friskt token, holdes tilbage, tjekket kører, og formularen sendes igen.
  • Hele siden er kun scriptet, i sidens hoved. Siden er dækket, indtil den besøgende består, og den fane bliver ikke spurgt igen, før beståelsen udløber.
  • En opsætning med udseendet Lys eller Mørk tilføjer data-theme="light" eller data-theme="dark".

Tjekket kører kun på opsætningens tilladte domæner.

Callbacks

Angiv en global funktion på div (eller på scriptet, for Hele siden) for at få besked om, hvad der skete:

window.xudaCaptcha.execute(element) returnerer et promise på et friskt token, til en formular, du sender fra din egen kode.

På din server

Send tokenet og opsætningens hemmelige nøgle med POST til captcha_siteverify. Accepter kun formularen, når svaret siger success. Opbevar den hemmelige nøgle i din servers egen konfiguration, aldrig 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 beståelse svarer:

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

Et token accepteres kun én gang og lever i to minutter. Bekræft det, når formularen kommer ind, ikke senere, og bekræft aldrig det samme token to gange.

Når det ikke består

success er false, og error-codes siger hvorfor:

Svaret har samme form som dem, reCAPTCHA og Turnstile giver, så servercode skrevet til dem normalt kun skal have ændret adresse og hemmelighed.

Plangrænser

Et tjek tælles, når en besøgendes første trin når frem til en afgørelse. Planens månedlige grænse læser tjekkene på dine egne sider og formularer. Alt, der hostes med Xuda, tælles ikke. Ved en grænse springes AI-trinnet over til næste måned, og hvert tjek kører videre, så ingen formular går i stykker. Se Planer og fakturering.

Hvordan er denne guide?

Sidst opdateret den 19. november 2026