Instalar el Widget
Agregue SilentShield a su sitio web con solo dos líneas de código. El Widget detecta automáticamente los formularios y comienza a protegerlos.
Integración Básica
Agregue este fragmento de código antes de la etiqueta de cierre </body> de su sitio web:
<script src="https://api.silentshield.io/client.js?key=YOUR_API_KEY" defer></script>
<script>
document.addEventListener('DOMContentLoaded', function() {
SilentShield.init({ apiKey: 'YOUR_API_KEY' });
});
</script>Qué Sucede Automáticamente
- El Widget detecta todos los formularios en la página
- El análisis de comportamiento se inicia en segundo plano (invisible para los usuarios)
- Un CAPTCHA aparece solo cuando se detecta un comportamiento sospechoso
- Un Nonce de verificación se inyecta en los formularios antes del envío
Verificación del Lado del Servidor (Recomendado)
Después de que se envía un formulario, valide el Nonce en su servidor para confirmar que el envío proviene de un humano.
POST https://api.silentshield.io/api/v1/captcha/verify-nonce
X-Api-Key: YOUR_API_KEY
PHPphp
<?php
$nonce = $_POST['ss_nonce'] ?? '';
$ch = curl_init('https://api.silentshield.io/api/v1/captcha/verify-nonce');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-Api-Key: ' . $apiKey,
],
CURLOPT_POSTFIELDS => json_encode(['nonce' => $nonce]),
CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['verdict'] === 'bot') {
http_response_code(403);
die('Bot detected');
}Node.jsjavascript
const response = await fetch('https://api.silentshield.io/api/v1/captcha/verify-nonce', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Api-Key': process.env.SILENTSHIELD_API_KEY,
},
body: JSON.stringify({ nonce: req.body.ss_nonce }),
});
const data = await response.json();
if (data.verdict === 'bot') {
return res.status(403).json({ error: 'Bot detected' });
}Pruebas
Agregue ?silentshield-debug a su URL para activar la superposición de depuración. Muestra la puntuación de comportamiento actual, el veredicto y las funcionalidades activas en tiempo real.