Hoppa till innehållet

Bot Protection

Håller botar borta från dina formulär, inloggningar och värdade webbplatser.

Öppna Bot Protection
Kontrollerad mot instrumentpanelen den 18 november 2026

Bot Protection har två sidor i kod. På din sida ritar ett litet skript kontrollen och lägger en token i ditt formulär när en besökare klarar den. På din server bekräftar en enda begäran den token med konfigurationens hemliga nyckel. Ingen av dem behöver en API-nyckel för kontot: konfigurationens egen sajtnyckel (publik) och hemliga nyckel (privat) är det som avgränsar dem.

Konfigurationerna själva, deras planer och deras siffror hanteras i dashboarden.

På din sida

Kopiera inbäddningskoden från konfigurationen. Den innehåller redan konfigurationens sajtnyckel. Så här ser den ut för varje sätt som kontrollen kan visas 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>
  • Kryssruta och Osynlig: lägg div inuti formuläret du vill skydda. Vid godkänd kontroll fyller skriptet ett dolt fält som heter xuda-captcha-response i det formuläret, så att token skickas med.
  • Osynlig visar ingenting. Ett formulär som skickas utan en färsk token hålls kvar, kontrollen körs och formuläret skickas igen.
  • Hela sidan är bara skriptet, i sidans head. Sidan täcks tills besökaren klarar kontrollen, och den fliken tillfrågas inte igen förrän godkännandet löper ut.
  • En konfiguration med utseendet Ljust eller Mörkt lägger till data-theme="light" eller data-theme="dark".

Kontrollen körs bara på konfigurationens tillåtna domäner.

Callbacks

Ange en global funktion på div (eller på skriptet, för Hela sidan) för att få veta vad som hände:

window.xudaCaptcha.execute(element) returnerar ett löfte om en färsk token, för ett formulär som du skickar från din egen kod.

På din server

Skicka token och konfigurationens hemliga nyckel med POST till captcha_siteverify. Godta formuläret bara när svaret säger success. Förvara den hemliga nyckeln i serverns egen konfiguration, aldrig på en sida.

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 godkänd kontroll ger svaret:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
En token gäller en gång, i två minuter

En token godtas bara en gång och lever i två minuter. Bekräfta den när formuläret kommer in, inte senare, och bekräfta aldrig samma token två gånger.

När den inte klarar kontrollen

success är false och error-codes säger varför:

Svaret har samma form som de som reCAPTCHA och Turnstile ger, så serverkod som skrivits för dem behöver oftast bara få sin adress och sin hemliga nyckel ändrade.

Plangränser

En kontroll räknas när en besökares första steg når ett beslut. Planens månadsgräns läser kontrollerna på dina egna sajter och formulär. Allt som hostas med Xuda räknas inte. Efter en gräns hoppas AI-steget över till nästa månad och varje kontroll fortsätter köras, så inget formulär går sönder. Se Planer och fakturering.

Hur är den här guiden?

Senast uppdaterad den 19 november 2026