Integrazzjoni JavaScript

Integra SilentShield fi kwalunkwe websajt bl-użu ta' JavaScript purat, jew uża l-gwidi speċifiċi tagħna għal React, Vue, u Angular.

1. Żid l-Iskript Tag

Żid dan l-iskript tag mal-HTML tiegħek, idealment qabel it-tag tal-għeluq </body>:

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

2. Inizjalizza l-Widget

Sejjaħ SilentShield.init() wara li d-DOM ikun tgħabba:

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

Għażliet ta' Konfigurazzjoni

apiKey

API key (meħtieġa)

lang

Kodiċi tal-lingwa jew 'auto' għal detezzjoni awtomatika tal-browser (default: 'auto'). Jappoġġja 25 lingwa.

thresholdSuspicious

Punteġġ taħt din il-limita jattiva sfida (default: 0.6)

thresholdBlock

Punteġġ taħt din il-limita jimblokka t-talba (default: 0.3)

telemetry

Attiva t-traċċar tal-imġiba (default: true)

captchaUI

Uri l-interfaċċja CAPTCHA meta meħtieġa (default: true)

fallbackCaptcha

Attiva l-CAPTCHA matematika bħala fallback (default: true)

showBrandingBadge

Uri l-badge 'Protett minn SilentShield' (default: true)

zeroPii

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

debugOverlay

Uri l-overlay tad-debug (default: false)

onVerdict

Funzjoni ta' callback li tissejjaħ meta jinkiseb verdett

Aqra n-Nonce

Wara s-sottomissjoni tal-formola, in-nonce huwa disponibbli bħala qasam moħbi:

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