JavaScript integrácia

Integrujte SilentShield do akejkoľvek webovej stránky pomocou čistého JavaScriptu alebo použite naše špecifické návody pre React, Vue a Angular.

1. Pridajte tag Script

Pridajte tento script tag do vášho HTML, ideálne pred uzatvárací tag </body>:

HTMLhtml
<script src="https://api.silentshield.io/client.js?key=YOUR_API_KEY" defer></script>

2. Inicializujte widget

Zavolajte SilentShield.init() po načítaní DOM:

JavaScriptjavascript
document.addEventListener('DOMContentLoaded', function() {
  SilentShield.init({
    apiKey: 'YOUR_API_KEY',
    lang: 'auto',
    features: {
      telemetry: true,
      captchaUI: true,
      fallbackCaptcha: true,
      showBrandingBadge: true,
    },
    onVerdict: function(response) {
      console.log('SilentShield verdict:', response);
    }
  });
});

Možnosti konfigurácie

apiKey
API kľúč (povinný)
lang
Kód jazyka alebo 'auto' pre detekciu prehliadača (predvolené: 'auto'). Podporuje 25 jazykov.
thresholdSuspicious
Skóre pod touto hodnotou spustí výzvu (predvolené: 0.6)
thresholdBlock
Skóre pod touto hodnotou zablokuje požiadavku (predvolené: 0.3)
telemetry
Povoliť sledovanie správania (predvolené: true)
captchaUI
Zobraziť CAPTCHA rozhranie podľa potreby (predvolené: true)
fallbackCaptcha
Povoliť Math CAPTCHA ako záložné riešenie (predvolené: true)
showBrandingBadge
Zobraziť odznak „Chránené SilentShield" (predvolené: true)
zeroPii
Disable browser fingerprinting for maximum privacy (default: false). See Features → Zero-PII Mode.
debugOverlay
Zobraziť ladiace prekrytie (predvolené: false)
onVerdict
Callback funkcia volaná pri prijatí verdiktu

Jednostránkové aplikácie (SPA)

Pre SPA s klientským smerovaním (React Router, Vue Router, atď.) SilentShield automaticky sleduje zmeny DOM a detekuje nové formuláre. Po navigácii nie je potrebná opätovná inicializácia.

Čítanie Nonce

Po odoslaní formulára je nonce dostupný ako skryté pole:

HTMLhtml
const nonce = document.querySelector('input[name="ss_nonce"]')?.value;