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?k=YOUR_API_KEY" crossorigin="anonymous" defer></script>

2. Inicializujte widget

Ruční inicializace není potřeba — client.js se inicializuje sám a načte konfiguraci widgetu (motiv, jazyk, odznak) z nastavení v dashboardu:

// No init call needed — client.js bootstraps itself as soon as it loads
// and pulls your widget configuration (theme, language, badge) from the
// dashboard: App → API keys → [your key] → Widget.

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="behavior_nonce"]')?.value;