Guide d’intégration

Démarrage rapide

BotFlush s’intègre en trois étapes : charger le widget, l’afficher puis vérifier les tokens côté serveur.

1. Charger le widget

Ajoutez le script du widget à votre page. Il se charge de façon asynchrone sans bloquer le rendu.

<script src="https://challenge.botflush.com/widget.js" async defer></script>

2. Ajouter le conteneur

Placez un élément conteneur à l’emplacement du CAPTCHA.

<div id="bf-captcha" data-sitekey="YOUR_SITE_KEY"></div>

3. Vérifier côté serveur

Quand l’utilisateur termine le défi, un token est généré. Envoyez-le à votre serveur puis vérifiez-le par API.

POST https://challenge.botflush.com/api/siteverify
Content-Type: application/json

{
  "secret": "YOUR_SECRET_KEY",
  "token": "TOKEN_FROM_CLIENT"
}

API JavaScript

BotFlush.render()

BotFlush.render('bf-captcha', {
  siteKey: 'YOUR_SITE_KEY',
  callback: function(token) {
    console.log('Verified:', token);
  }
});

BotFlush.reset()

BotFlush.reset();

BotFlush.getResponse()

var token = BotFlush.getResponse();

Notes de migration

BotFlush prend en charge les modèles widget et siteverify familiers. Commencez par l’URL du script, les clés et l’endpoint; testez callbacks et erreurs avant déploiement.

<!-- Before -->
<script src="https://www.google.com/recaptcha/api.js"></script>
<div class="g-recaptcha" data-sitekey="GOOGLE_KEY"></div>

<!-- After -->
<script src="https://challenge.botflush.com/widget.js"></script>
<div class="g-recaptcha" data-sitekey="BOTFLUSH_KEY"></div>

Contrôles de confidentialité

BotFlush is designed around minimized data use, account-level controls, and enterprise review workflows. The console remains the source of truth for currently available privacy and data controls.

Modes de vérification

BotFlush propose plusieurs moteurs de défi. Configurez les moteurs autorisés par site dans la console.

Vérification serveur

Node.js

const res = await fetch('https://challenge.botflush.com/api/siteverify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ secret, token })
});

Python

resp = requests.post('https://challenge.botflush.com/api/siteverify', json={
    'secret': BOTFLUSH_SECRET,
    'token': token
})

Go

resp, _ := http.Post("https://challenge.botflush.com/api/siteverify",
    "application/json", bytes.NewBuffer(payload))

Téléchargements

Node Inspector — extension Chrome

Installation: Téléchargez puis décompressez, ouvrez les extensions Chrome, activez le mode développeur et chargez le dossier décompressé.