Siirry sisältöön

Bot Protection

Pitää botit poissa lomakkeiltasi, kirjautumisistasi ja isännöidyiltä sivustoiltasi.

Avaa Bot Protection
Tarkistettu koontinäyttöä vasten 18. marraskuuta 2026

Bot Protectionilla on koodissa kaksi puolta. Sivullasi pieni skripti piirtää tarkistuksen ja lisää lomakkeeseesi tunnisteen (token), kun kävijä pääsee läpi. Palvelimellasi yksi pyyntö vahvistaa tämän tunnisteen määrityksen salaisella avaimella. Kumpikaan ei tarvitse tilin API-avainta: niiden rajaus tulee määrityksen omasta sivustoavaimesta (julkinen) ja salaisesta avaimesta (yksityinen).

Itse määrityksiä, niiden paketteja ja niiden lukuja hallitaan hallintapaneelissa.

Sivullasi

Kopioi upotuskoodi määrityksestä. Siinä on jo määrityksen sivustoavain. Tässä sen muoto kullekin tarkistuksen näkymistavalle.

<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>
  • Valintaruutu ja Näkymätön: aseta div suojattavan lomakkeen sisään. Läpäisyn jälkeen skripti täyttää kyseisessä lomakkeessa piilokentän nimeltä xuda-captcha-response, jolloin tunniste lähetetään lomakkeen mukana.
  • Näkymätön ei näytä mitään. Lomake, joka lähetetään ilman tuoretta tunnistetta, pysäytetään, tarkistus ajetaan ja lomake lähetetään uudelleen.
  • Koko sivu on pelkkä skripti sivun head-osassa. Sivu on peitetty, kunnes kävijä pääsee läpi, eikä samaa välilehteä pyydetä uudelleen, ennen kuin sen läpäisy umpeutuu.
  • Määritys, jonka ulkoasu on Light tai Dark, lisää data-theme="light" tai data-theme="dark".

Tarkistus toimii vain määrityksen sallituilla verkkotunnuksilla.

Takaisinkutsut

Nimeä globaali funktio div-elementille (tai Koko sivu -tilassa skriptille), jotta saat tiedon tapahtuneesta:

window.xudaCaptcha.execute(element) palauttaa lupauksen (promise) tuoreesta tunnisteesta, lomakkeelle jonka lähetät omasta koodistasi.

Palvelimellasi

Lähetä tunniste ja määrityksen salainen avain metodille captcha_siteverify. Hyväksy lomake vasta, kun vastauksessa lukee success. Pidä salainen avain palvelimesi omassa konfiguraatiossa, älä koskaan sivulla.

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

Läpäisy vastaa:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Tunniste kelpaa kerran, kahdeksi minuutiksi

Tunniste hyväksytään vain kerran, ja se elää kaksi minuuttia. Vahvista se, kun lomake saapuu, ei myöhemmin, äläkä vahvista samaa tunnistetta kahdesti.

Kun läpäisy ei onnistu

success on false, ja error-codes kertoo syyn:

Vastauksen muoto on sama kuin reCAPTCHAn ja Turnstilen antamilla, joten niitä varten kirjoitettuun palvelinkoodiin riittää yleensä osoitteen ja salaisen avaimen vaihto.

Paketin rajat

Tarkistus lasketaan, kun kävijän ensimmäinen vaihe johtaa päätökseen. Paketin kuukausiraja lukee omien sivustojesi ja lomakkeidesi tarkistukset. Mitään Xudalla isännöityä ei lasketa. Rajan jälkeen tekoälyvaihe ohitetaan seuraavaan kuuhun asti ja kaikki tarkistukset jatkavat toimintaansa, joten mikään lomake ei rikkoudu. Katso Paketit ja laskutus.

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026