Integrare JavaScript

Integrează SilentShield în orice site web folosind JavaScript simplu sau folosește ghidurile noastre specifice pentru React, Vue și Angular.

1. Adaugă tagul Script

Adaugă acest tag script în HTML-ul tău, ideal înainte de tagul de închidere </body>:

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

2. Inițializează widgetul

Apelează SilentShield.init() după ce DOM-ul s-a încărcat:

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);
    }
  });
});

Opțiuni de configurare

apiKey

Cheie API (obligatorie)

lang

Cod de limbă sau 'auto' pentru detectarea browserului (implicit: 'auto'). Suportă 25 de limbi.

thresholdSuspicious

Scorul sub acest prag declanșează o provocare (implicit: 0.6)

thresholdBlock

Scorul sub acest prag blochează cererea (implicit: 0.3)

telemetry

Activează urmărirea comportamentului (implicit: true)

captchaUI

Afișează interfața CAPTCHA când este necesar (implicit: true)

fallbackCaptcha

Activează Math CAPTCHA ca alternativă (implicit: true)

showBrandingBadge

Afișează insigna „Protejat de SilentShield" (implicit: true)

zeroPii

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

debugOverlay

Afișează overlay-ul de depanare (implicit: false)

onVerdict

Funcție callback apelată la primirea unui verdict

Citirea Nonce-ului

După trimiterea formularului, nonce-ul este disponibil ca un câmp ascuns:

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