De Widget installeren
Voeg SilentShield toe aan uw website met slechts twee regels code. De Widget detecteert automatisch formulieren en begint ze te beschermen.
Basisintegratie
Voeg dit codefragment toe vóór de afsluitende </body>-tag van uw website:
<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>Wat er automatisch gebeurt
- De Widget detecteert alle formulieren op de pagina
- Gedragsanalyse start op de achtergrond (onzichtbaar voor gebruikers)
- Een CAPTCHA verschijnt alleen wanneer verdacht gedrag wordt gedetecteerd
- Een verificatie-Nonce wordt in formulieren geïnjecteerd vóór verzending
Serververificatie (aanbevolen)
Nadat een formulier is verzonden, valideert u de Nonce op uw server om te bevestigen dat de inzending van een mens afkomstig is.
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' });
}Testen
Voeg ?silentshield-debug toe aan uw URL om de debug-overlay te activeren. Deze toont in realtime de huidige gedragsscore, het oordeel en de actieve functies.