İçeriğe geç

Bot Protection

Botları formlarınızdan, girişlerinizden ve barındırılan sitelerinizden uzak tutar.

Bot Protection aç
18 Kasım 2026 tarihinde kontrol paneliyle karşılaştırıldı

Bot Protection'ın kodda iki tarafı vardır. Sayfanızda küçük bir betik kontrolü çizer ve bir ziyaretçi geçtiğinde formunuza bir belirteç koyar. Sunucunuzda tek bir istek, bu belirteci kurulumun gizli anahtarıyla onaylar. İkisi de hesap API anahtarı gerektirmez: onları kapsayan şey, bir kurulumun kendi site anahtarı (herkese açık) ve gizli anahtarıdır (özel).

Kurulumların kendileri, planları ve sayıları kontrol panelinden yönetilir.

Sayfanızda

Yerleştirme kodunu kurulumdan kopyalayın; kurulumun site anahtarı zaten içindedir. Kontrolün göründüğü her biçim için şekli şudur.

<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>
  • Onay kutusu ve Görünmez: div öğesini korumak istediğiniz formun içine koyun. Geçişte betik, o formdaki xuda-captcha-response adlı gizli alanı doldurur; böylece belirteç formla birlikte gönderilir.
  • Görünmez hiçbir şey göstermez. Taze bir belirteci olmadan gönderilen form bekletilir, kontrol çalışır ve form yeniden gönderilir.
  • Tam sayfa yalnızca betiktir ve sayfanın head bölümüne konur. Ziyaretçi geçene kadar sayfa kaplanır ve geçişin süresi dolana kadar o sekmeden bir daha istenmez.
  • Görünümü Açık veya Koyu olan bir kurulum data-theme="light" veya data-theme="dark" ekler.

Kontrol yalnızca kurulumun izin verilen alan adlarında çalışır.

Geri çağrılar

Neler olduğunu öğrenmek için div üzerinde (Tam sayfada betik üzerinde) genel bir işlev adı verin:

window.xudaCaptcha.execute(element), kendi kodunuzdan gönderdiğiniz bir form için taze bir belirteç sözü döndürür.

Sunucunuzda

Belirteci ve kurulumun gizli anahtarını captcha_siteverify yöntemine gönderin. Formu yalnızca yanıt success dediğinde kabul edin. Gizli anahtarı sunucunuzun kendi yapılandırmasında tutun, asla bir sayfada değil.

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

Başarılı bir geçiş şu yanıtı verir:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Bir belirteç bir kez, iki dakika geçerlidir

Bir belirteç yalnızca bir kez kabul edilir ve iki dakika yaşar. Onu form geldiğinde onaylayın, daha sonra değil, ve aynı belirteci asla iki kez onaylamayın.

Geçmediğinde

success değeri false olur ve error-codes nedenini söyler:

Yanıt, reCAPTCHA ve Turnstile'ın verdikleriyle aynı biçimdedir; bu yüzden onlar için yazılmış sunucu kodunda genellikle yalnızca adres ve gizli anahtar değiştirilir.

Plan sınırları

Bir ziyaretçinin ilk adımı bir karara ulaştığında bir kontrol sayılır. Planın aylık sınırı, kendi sitelerinizdeki ve formlarınızdaki kontrolleri okur; Xuda ile barındırılan hiçbir şey sayılmaz. Bir sınırın ötesinde yapay zeka adımı gelecek aya kadar atlanır ve her kontrol çalışmaya devam eder, böylece hiçbir form bozulmaz. Bkz. Planlar ve faturalandırma.

Bu kılavuz nasıl?

Son güncelleme: 19 Kasım 2026