Μετάβαση στο περιεχόμενο

Bot Protection

Κρατά τα bots μακριά από τις φόρμες, τις συνδέσεις και τους φιλοξενούμενους ιστότοπούς σας.

Άνοιγμα του Bot Protection
Ελέγχθηκε με τον πίνακα ελέγχου στις 18 Νοεμβρίου 2026

Το Bot Protection έχει δύο πλευρές στον κώδικα. Στη σελίδα σας, ένα μικρό script σχεδιάζει τον έλεγχο και βάζει ένα token στη φόρμα σας όταν ένας επισκέπτης περνά. Στον διακομιστή σας, ένα αίτημα επιβεβαιώνει αυτό το token με το μυστικό κλειδί της ρύθμισης. Κανένα από τα δύο δεν χρειάζεται κλειδί API λογαριασμού: το κλειδί ιστότοπου (δημόσιο) και το μυστικό κλειδί (ιδιωτικό) κάθε ρύθμισης είναι αυτά που τα οριοθετούν.

Οι ίδιες οι ρυθμίσεις, τα πλάνα τους και τα νούμερά τους διαχειρίζονται από τον πίνακα ελέγχου.

Στη σελίδα σας

Αντιγράψτε τον κώδικα ενσωμάτωσης από τη ρύθμιση· περιέχει ήδη το κλειδί ιστότοπου της ρύθμισης. Αυτή είναι η μορφή του για κάθε τρόπο εμφάνισης του ελέγχου.

<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>
  • Πλαίσιο ελέγχου και Αόρατο: βάλτε το div μέσα στη φόρμα που θέλετε να προστατέψετε. Όταν ο επισκέπτης περνά, το script συμπληρώνει ένα κρυφό πεδίο με όνομα xuda-captcha-response σε αυτή τη φόρμα, ώστε το token να αποστέλλεται μαζί της.
  • Το Αόρατο δεν δείχνει τίποτα. Μια φόρμα που στέλνεται χωρίς φρέσκο token κρατιέται, ο έλεγχος τρέχει και η φόρμα στέλνεται ξανά.
  • Η Ολόκληρη σελίδα είναι μόνο το script, στο head της σελίδας. Η σελίδα καλύπτεται μέχρι να περάσει ο επισκέπτης, και αυτή η καρτέλα δεν ερωτάται ξανά μέχρι να λήξει η επιτυχία της.
  • Μια ρύθμιση με εμφάνιση Φωτεινή ή Σκούρη προσθέτει data-theme="light" ή data-theme="dark".

Ο έλεγχος λειτουργεί μόνο στους επιτρεπόμενους τομείς της ρύθμισης.

Callbacks

Ονομάστε μια καθολική συνάρτηση στο div (ή στο script, για την Ολόκληρη σελίδα) για να ενημερώνεστε τι συνέβη:

Το window.xudaCaptcha.execute(element) επιστρέφει ένα promise για ένα φρέσκο token, για μια φόρμα που στέλνετε από δικό σας κώδικα.

Στον διακομιστή σας

Στείλτε με POST το token και το μυστικό κλειδί της ρύθμισης στο captcha_siteverify. Δεχτείτε τη φόρμα μόνο όταν η απάντηση λέει success. Κρατήστε το μυστικό κλειδί στη δική σας διαμόρφωση του διακομιστή, ποτέ σε σελίδα.

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

Μια επιτυχία απαντά:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Ένα token ισχύει μία φορά, για δύο λεπτά

Ένα token γίνεται δεκτό μία μόνο φορά και ζει δύο λεπτά. Επιβεβαιώστε το όταν φτάνει η φόρμα, όχι αργότερα, και μην επιβεβαιώσετε ποτέ το ίδιο token δύο φορές.

Όταν δεν περνά

Το success είναι false και το error-codes λέει γιατί:

Η απάντηση έχει την ίδια μορφή με αυτές του reCAPTCHA και του Turnstile, οπότε ο κώδικας διακομιστή που γράφτηκε για αυτά συνήθως χρειάζεται μόνο αλλαγή της διεύθυνσης και του μυστικού.

Όρια πλάνου

Ένας έλεγχος μετρά όταν το πρώτο βήμα ενός επισκέπτη φτάνει σε απόφαση. Το μηνιαίο όριο του πλάνου διαβάζει τους ελέγχους στους δικούς σας ιστότοπους και φόρμες· ό,τι φιλοξενείται με το Xuda δεν μετρά. Πέρα από ένα όριο το βήμα AI παραλείπεται μέχρι τον επόμενο μήνα και κάθε έλεγχος συνεχίζει να τρέχει, ώστε καμία φόρμα να μην χαλά. Δείτε Πλάνα και χρέωση.

Πώς σας φαίνεται αυτός ο οδηγός;

Τελευταία ενημέρωση: 20 Νοεμβρίου 2026