Inštalácia widgetu
Pridajte SilentShield na svoju webovú stránku len dvoma riadkami kódu. Widget automaticky detekuje formuláre a začne ich chrániť.
Základná integrácia
Pridajte tento kúsok kódu pred uzatvárací tag </body> vašej webovej stránky:
<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>Čo sa stane automaticky
- Widget detekuje všetky formuláre na stránke
- Analýza správania sa spustí na pozadí (neviditeľná pre používateľov)
- CAPTCHA sa zobrazí iba pri detekcii podozrivého správania
- Overovací nonce sa vloží do formulárov pred odoslaním
Overenie na strane servera (Odporúčané)
Po odoslaní formulára overte nonce na vašom serveri, aby ste potvrdili, že odoslanie pochádza od človeka.
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' });
}Testovanie
Pridajte ?silentshield-debug k vašej URL adrese na aktiváciu ladiacieho prekrytia. Zobrazuje v reálnom čase aktuálne skóre správania, verdikt a aktívne funkcie.