Documentación — BotFlush

Inicio rápido

BotFlush se integra en tres pasos: cargar el widget, renderizarlo y verificar los tokens en el servidor.

1. Cargar widget

Añada el script del widget a la página. Carga de forma asíncrona y no bloquea el renderizado.

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

2. Añadir contenedor

Coloque un contenedor donde quiera mostrar el CAPTCHA.

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

3. Verificar en servidor

Al completar el reto se genera un token. Envíelo al servidor y verifíquelo por API.

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

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

JavaScript API

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();

Notas de migración

BotFlush admite patrones familiares de widget y siteverify. Empiece por cambiar URL del script, claves y endpoint; pruebe callbacks y manejo de errores antes del despliegue.

<!-- Before -->
<script src="https://legacy-captcha.example/api.js"></script>
<div class="captcha-widget" data-sitekey="LEGACY_SITE_KEY"></div>

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

Controles de privacidad

BotFlush está diseñado para minimizar el uso de datos, ofrecer controles a nivel de cuenta y admitir flujos de revisión empresariales. La consola sigue siendo la fuente fiable para conocer los controles de privacidad y datos disponibles actualmente.

Modos de verificación

BotFlush ofrece varios motores de reto. Configure los motores permitidos por sitio en la consola.

Motor	Tipo	Descripción
Invisible Free	Fondo	Prueba de trabajo sin interacción del usuario
Visual Match	Interactivo	Emparejamiento visual de patrones
Emoji Click	Interactivo	Selección del emoji correcto en una cuadrícula visual
Invisible Max	Fondo	Prueba de trabajo acelerada por GPU

Verificación del servidor

El endpoint de verificación acepta una solicitud POST estándar. Seleccione un entorno de servidor para ver el ejemplo correspondiente.

const response = await fetch('https://challenge.botflush.com/api/siteverify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    secret: process.env.BOTFLUSH_SECRET,
    token: req.body['bf-token']
  })
});

const result = await response.json();
if (!result.success) {
  return res.status(403).send('Verification failed');
}

import requests

response = requests.post('https://challenge.botflush.com/api/siteverify', json={
    'secret': BOTFLUSH_SECRET,
    'token': request.form['bf-token'],
})

if not response.json().get('success'):
    abort(403)

$payload = json_encode([
  'secret' => getenv('BOTFLUSH_SECRET'),
  'token' => $_POST['bf-token'] ?? ''
]);

$context = stream_context_create(['http' => [
  'method' => 'POST',
  'header' => 'Content-Type: application/json',
  'content' => $payload,
]]);

$response = file_get_contents('https://challenge.botflush.com/api/siteverify', false, $context);
$result = json_decode($response, true);
if (empty($result['success'])) { http_response_code(403); exit; }

payload, _ := json.Marshal(map[string]string{
    "secret": os.Getenv("BOTFLUSH_SECRET"),
    "token":  r.FormValue("bf-token"),
})

resp, err := http.Post("https://challenge.botflush.com/api/siteverify",
    "application/json", bytes.NewBuffer(payload))
if err != nil { http.Error(w, "verify failed", 502); return }
defer resp.Body.Close()

var result struct{ Success bool }
json.NewDecoder(resp.Body).Decode(&result)
if !result.Success { w.WriteHeader(http.StatusForbidden); return }

HttpClient client = HttpClient.newHttpClient();
String body = """
{
  "secret": "%s",
  "token": "%s"
}
""".formatted(System.getenv("BOTFLUSH_SECRET"), token);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://challenge.botflush.com/api/siteverify"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
Map<String, Object> result = new ObjectMapper().readValue(response.body(), Map.class);
if (!Boolean.TRUE.equals(result.get("success"))) {
    throw new SecurityException("Verification failed");
}

using var client = new HttpClient();
var payload = new {
    secret = Environment.GetEnvironmentVariable("BOTFLUSH_SECRET"),
    token = Request.Form["bf-token"].ToString()
};

var response = await client.PostAsJsonAsync(
    "https://challenge.botflush.com/api/siteverify",
    payload);
var result = await response.Content.ReadFromJsonAsync<VerifyResult>();

if (result?.Success != true) {
    return Forbid();
}

Descargas

Node Inspector — extensión de Chrome

Instalación: Descargue y descomprima, abra las extensiones de Chrome, active el modo de desarrollador y cargue la carpeta descomprimida.

Descargar Node Inspector (.zip)

Guía de integración