Naar de inhoud springen

Bot Protection

Houdt bots weg van je formulieren, inlogschermen en gehoste sites.

Bot Protection openen
Gecontroleerd aan de hand van het dashboard op 18 november 2026

Bot Protection heeft in code twee kanten. Op je pagina tekent een klein script de controle en zet het een token in je formulier wanneer een bezoeker erdoor komt. Op je server bevestigt één aanvraag dat token met de geheime sleutel van de setup. Geen van beide heeft een API-sleutel van een account nodig: de eigen sitesleutel (openbaar) en geheime sleutel (privé) van een setup bepalen hun bereik.

De setups zelf, hun abonnementen en hun cijfers beheer je in het dashboard.

Op je pagina

Kopieer de insluitcode uit de setup; hij bevat al de sitesleutel van de setup. Dit is de vorm voor elke manier waarop de controle verschijnt.

<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>
  • Selectievakje en Onzichtbaar: zet de div in het formulier dat je wilt beschermen. Bij een geslaagde controle vult het script een verborgen veld met de naam xuda-captcha-response in dat formulier, zodat het token mee wordt verstuurd.
  • Onzichtbaar toont niets. Een formulier dat zonder vers token wordt verstuurd, wordt vastgehouden, de controle draait en het formulier wordt opnieuw verstuurd.
  • Hele pagina is alleen het script, in de head van de pagina. De pagina is afgedekt totdat de bezoeker erdoor is, en dat tabblad krijgt de vraag niet opnieuw totdat zijn geslaagde controle verloopt.
  • Een setup met als uiterlijk Licht of Donker voegt data-theme="light" of data-theme="dark" toe.

De controle draait alleen op de toegestane domeinen van de setup.

Callbacks

Geef een globale functie een naam op de div (of op het script, bij Hele pagina) om te horen wat er gebeurde:

window.xudaCaptcha.execute(element) geeft een promise van een vers token terug, voor een formulier dat je vanuit je eigen code verstuurt.

Op je server

Post het token en de geheime sleutel van de setup naar captcha_siteverify. Accepteer het formulier alleen wanneer het antwoord success zegt. Bewaar de geheime sleutel in de eigen configuratie van je server, nooit in een pagina.

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

Een geslaagde controle geeft als antwoord:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Een token is één keer geldig, twee minuten lang

Een token wordt maar één keer geaccepteerd en leeft twee minuten. Bevestig het wanneer het formulier binnenkomt, niet later, en bevestig nooit twee keer hetzelfde token.

Wanneer het niet slaagt

success is false en error-codes zegt waarom:

Het antwoord heeft dezelfde vorm als dat van reCAPTCHA en Turnstile, dus servercode die daarvoor is geschreven, hoeft meestal alleen van adres en geheim te veranderen.

Abonnementslimieten

Een controle wordt geteld wanneer de eerste stap van een bezoeker tot een beslissing komt. De maandlimiet van het abonnement leest de controles op je eigen sites en formulieren; alles wat met Xuda wordt gehost, telt niet mee. Boven een limiet wordt de AI-stap tot volgende maand overgeslagen en blijft elke controle draaien, dus er gaat geen formulier kapot. Zie Abonnementen en facturering.

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026