Przejdź do treści

Bot Protection

Trzyma boty z dala od Twoich formularzy, logowań i hostowanych stron.

Otwórz Bot Protection
Sprawdzono z pulpitem dnia 18 listopada 2026

Bot Protection ma w kodzie dwie strony. Na Twojej stronie mały skrypt rysuje kontrolę i umieszcza w formularzu token, gdy odwiedzający ją przejdzie. Na Twoim serwerze jedno żądanie potwierdza ten token za pomocą klucza tajnego konfiguracji. Żadne z nich nie potrzebuje klucza API konta: zakres wyznaczają klucz witryny (publiczny) i klucz tajny (prywatny) danej konfiguracji.

Same konfiguracje, ich plany i liczby zarządzasz w dashboardzie.

Na Twojej stronie

Skopiuj kod do osadzenia z konfiguracji; ma już w sobie klucz witryny. Tak wygląda dla każdego sposobu wyświetlania kontroli.

<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>
  • Checkbox i Invisible: umieść div wewnątrz formularza, który chcesz chronić. Po przejściu kontroli skrypt wypełnia w tym formularzu ukryte pole o nazwie xuda-captcha-response, więc token jest wysyłany razem z formularzem.
  • Invisible niczego nie pokazuje. Formularz wysłany bez świeżego tokena jest wstrzymywany, kontrola działa, a formularz wysyła się ponownie.
  • Full page to sam skrypt, w nagłówku (head) strony. Strona jest zasłonięta, dopóki odwiedzający nie przejdzie kontroli, a ta karta nie jest pytana ponownie, dopóki jej przepustka nie wygaśnie.
  • Konfiguracja z wyglądem Jasny lub Ciemny dodaje data-theme="light" albo data-theme="dark".

Kontrola działa tylko na dozwolonych domenach konfiguracji.

Wywołania zwrotne

Nazwij globalną funkcję na div (albo na skrypcie, dla Full page), aby dowiedzieć się, co się stało:

window.xudaCaptcha.execute(element) zwraca obietnicę (promise) świeżego tokena, dla formularza wysyłanego z Twojego własnego kodu.

Na Twoim serwerze

Wyślij token i klucz tajny konfiguracji do captcha_siteverify. Przyjmij formularz tylko wtedy, gdy odpowiedź zawiera success. Klucz tajny trzymaj we własnej konfiguracji serwera, nigdy na stronie.

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

Udane przejście zwraca:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Token jest ważny raz, przez dwie minuty

Token jest przyjmowany tylko jeden raz i żyje dwie minuty. Potwierdź go, gdy formularz dotrze, nie później, i nigdy nie potwierdzaj tego samego tokena dwa razy.

Gdy kontrola nie przechodzi

success ma wartość false, a error-codes mówi dlaczego:

Odpowiedź ma ten sam kształt co odpowiedzi reCAPTCHA i Turnstile, więc kod serwera napisany dla nich zwykle wymaga tylko zmiany adresu i klucza tajnego.

Limity planu

Kontrola jest liczona, gdy pierwszy krok odwiedzającego dochodzi do decyzji. Miesięczny limit planu odczytuje kontrole na Twoich własnych stronach i formularzach; wszystko hostowane w Xuda nie jest liczone. Po przekroczeniu limitu krok AI jest pomijany do następnego miesiąca, a każda kontrola nadal działa, więc żaden formularz się nie psuje. Zobacz Plany i rozliczenia.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026