JavaScript integrace

Integrujte SilentShield do jakéhokoliv webu pomocí čistého JavaScriptu, nebo použijte naše průvodce pro React, Vue a Angular.

1. Přidejte script tag

Přidejte tento script tag do svého HTML, ideálně před uzavírací tag </body>:

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

2. Inicializujte widget

Zavolejte SilentShield.init() po načtení DOM:

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 konfigurace

apiKey

API klíč (povinný)

lang

Kód jazyka nebo 'auto' pro detekci jazyka prohlížeče (výchozí: 'auto'). Podporuje 25 jazyků.

thresholdSuspicious

Skóre pod touto hodnotou spustí výzvu (výchozí: 0.6)

thresholdBlock

Skóre pod touto hodnotou zablokuje požadavek (výchozí: 0.3)

telemetry

Povolit sledování chování (výchozí: true)

captchaUI

Zobrazit CAPTCHA rozhraní v případě potřeby (výchozí: true)

fallbackCaptcha

Povolit záložní matematickou CAPTCHA (výchozí: true)

showBrandingBadge

Zobrazit odznak „Chráněno SilentShield" (výchozí: true)

zeroPii

Disable browser fingerprinting for maximum privacy (default: false). See Features → Zero-PII Mode.

debugOverlay

Zobrazit debugovací překrytí (výchozí: false)

onVerdict

Callback funkce volaná při přijetí verdiktu

Čtení nonce

Po odeslání formuláře je nonce dostupný jako skryté pole:

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