Documentazione per Sviluppatori

Protezione invisibile contro i bot. Nessun CAPTCHA. API-first.

Avvio rapido in 60 s Ottieni Chiave del Sito

Avvio Rapido

Installa e Incorpora

Aggiungi lo script e ottieni un token

Verifica sul Server

Convalida il token sul tuo backend

Test Veloce con cURL

Verifica il nonce dalla riga di comando

# Verifica Nonce
curl -X POST https://api.silentshield.io/v1/verify \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nonce": "256ea6c63c3ccdd317e05cbc9ef0c659"}'

Frontend Integration

Add the client script with SRI and defer attributes

<!-- Add to <head> with SRI for security -->
(function () {
  var KEY = "YOUR_API_KEY";
  var SITE = location.hostname;
  var V = "2025.09.1";
  var s = document.createElement('script');
  s.src = "https://api.silentshield.io/client.js?k=" + encodeURIComponent(KEY)
    + "&v=" + encodeURIComponent(V)
    + "&site=" + encodeURIComponent(SITE);
  s.async = true;
  s.crossOrigin = "anonymous";
  document.head.appendChild(s);
})();

Sicurezza e Privacy

Nessun cookie – funzionamento completamente senza cookie
Nessuna raccolta di PII – conforme a GDPR e CCPA
Hosting UE – tutti i dati rimangono in Europa
Conforme a WCAG – accessibile a tutti gli utenti
Compatibile con CSP – utilizza con Content Security Policy:

Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Riferimento API

API Version: 2025-10-01 · Base URL: https://api.silentshield.io

POST/v1/verify

Verifica SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY

Content-Typeapplication/json

Request Body:

tokenstringIl Nonce da verificare

Response:

Success (200):

{
  "ok": true,
  "verdict": "human",
  "confidence": 0.95,
  "request_nonce": "req_abc123"
}

Error:

{
  "ok": false,
  "verdict": "error",
  "confidence": 0,
  "request_nonce": "req_abc123",
  "error": "Invalid nonce"
}

Status Codes:

200Nonce verificato con successo

400Richiesta non valida (Nonce mancante o errato)

401Chiave API non valida

429Limite di velocità superato (100 richieste/min.)

500Errore interno del server

SDK e Librerie

Il pacchetto gira sul tuo server (Node.js 18 o successivo). Nel browser non serve alcun pacchetto: lì basta lo snippet client.js della guida rapida.

Node.js / Express

v1.2.0

npm i @forge12interactive/silentshield-sdk-js

import { createClient } from "@forge12interactive/silentshield-sdk-js";

const shield = createClient({ apiKey: process.env.SILENTSHIELD_API_KEY });

app.post("/signup", async (req, res) => {
  const { human } = await shield.verify(req.body.behavior_nonce);
  if (!human) return res.status(403).send("Verification failed");
  res.send("ok");
});

GitHub NPM

Agenti IA (Node.js)

v1.2.0

npm i @forge12interactive/silentshield-sdk-js

import { createClient, enforce } from "@forge12interactive/silentshield-sdk-js";

const shield = createClient({ apiKey: process.env.SILENTSHIELD_API_KEY });

// Reports bot candidates only — never blocks, never sees human traffic.
app.use(shield.observe);

// Applies your policy locally from a signed bundle. Fail-open.
app.use(enforce({ apiKey: process.env.SILENTSHIELD_API_KEY }));

GitHub NPM

Resources

Help Center

Comprehensive documentation with getting started guides, integration tutorials, configuration references, and troubleshooting.

Open Help Center

Changelog

Stay up to date with the latest features, improvements, and fixes.

View Changelog

Pronto per iniziare?

Crea un account gratuito e ottieni la tua chiave del sito in pochi secondi.

Inizia Ora