Ugrás a tartalomhoz

Bot Protection

Távol tartja a botokat az űrlapjaitól, bejelentkezéseitől és tárolt weboldalaitól.

Bot Protection megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 18.

A Bot Protection kódban két oldalból áll. Az oldalán egy kis szkript megrajzolja az ellenőrzést, és egy tokent tesz az űrlapjába, amikor a látogató átjut. A szerverén egyetlen kérés erősíti meg ezt a tokent a beállítás titkos kulcsával. Egyikhez sem kell fiók API-kulcs: a beállítás saját webhelykulcsa (nyilvános) és titkos kulcsa (privát) határolja be őket.

Magukat a beállításokat, a csomagjaikat és a számaikat a vezérlőpulton kezelheti.

Az oldalán

Másolja ki a beágyazási kódot a beállításból; az már tartalmazza a beállítás webhelykulcsát. Az alábbi az alakja az ellenőrzés minden megjelenési módjához.

<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>
  • Jelölőnégyzet és Láthatatlan: a div kerüljön a védeni kívánt űrlapba. Átjutáskor a szkript kitölt egy xuda-captcha-response nevű rejtett mezőt az űrlapban, így a token vele együtt kerül elküldésre.
  • A Láthatatlan semmit sem mutat. A friss token nélkül elküldött űrlapot visszatartja, lefut az ellenőrzés, és az űrlap újra elküldésre kerül.
  • A Teljes oldal csak a szkript, az oldal fejrészében. Az oldal le van takarva, amíg a látogató át nem jut, és az adott lapot addig nem kérdezi újra, amíg az átjutása le nem jár.
  • Az a beállítás, amelynek megjelenése Világos vagy Sötét, data-theme="light" vagy data-theme="dark" attribútumot ad hozzá.

Az ellenőrzés csak a beállítás engedélyezett tartományain fut.

Visszahívások

Nevezzen meg egy globális függvényt a div-en (vagy a Teljes oldal esetén a szkripten), hogy értesüljön arról, mi történt:

A window.xudaCaptcha.execute(element) egy friss token ígéretét adja vissza, a saját kódjából küldött űrlaphoz.

A szerverén

Küldje el a tokent és a beállítás titkos kulcsát a captcha_siteverify metódusnak. Az űrlapot csak akkor fogadja el, ha a válasz success-t mond. A titkos kulcsot a szervere saját konfigurációjában tartsa, soha ne egy oldalon.

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

Sikeres átjutás esetén a válasz:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Egy token egyszer érvényes, két percig

A tokent csak egyszer fogadjuk el, és két percig él. Erősítse meg, amikor az űrlap megérkezik, ne később, és soha ne erősítse meg ugyanazt a tokent kétszer.

Ha nem jut át

A success értéke false, és az error-codes megmondja az okot:

A válasz ugyanolyan alakú, mint amilyet a reCAPTCHA és a Turnstile ad, ezért az azokhoz írt szerverkódban általában csak a címet és a titkos kulcsot kell cserélni.

Csomagkorlátok

Egy ellenőrzést akkor számolunk, amikor a látogató első lépése döntéshez ér. A csomag havi korlátja az Ön saját webhelyein és űrlapjain végzett ellenőrzéseket olvassa; a Xuda-nál hosztolt dolgok nem számítanak. A korláton túl az AI lépést a következő hónapig kihagyjuk, és minden ellenőrzés tovább fut, így egyetlen űrlap sem romlik el. Lásd: Csomagok és számlázás.

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.