SilentShield

Documentation Développeur

Protection invisible contre les bots. Pas de CAPTCHAs. API-first.

Démarrage rapide en 60 sObtenir la Clé de Site

Démarrage Rapide

1

Installer et Intégrer

Ajouter le script et obtenir un jeton (token)

2

Vérifier sur le Serveur

Valider le jeton sur votre backend

Test Rapide avec cURL

Vérifier le nonce via la ligne de commande

# Vérifier le 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);
})();

Sécurité et Confidentialité

  • Pas de cookies – fonctionnement entièrement sans cookies
  • Pas de collecte de PII – conforme au RGPD et au CCPA
  • Hébergement dans l'UE – toutes les données restent en Europe
  • Conforme WCAG – accessible à tous les utilisateurs
  • Compatible CSP – utiliser avec Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Référence API

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

POST/v1/verify

Vérifier le Nonce SilentShield

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringLe Nonce à vérifier

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 vérifié avec succès
400Requête invalide (Nonce manquant ou incorrect)
401Clé API invalide
429Limite de taux dépassée
500Erreur interne du serveur

SDKs et Bibliothèques

Le paquet s'exécute sur votre serveur (Node.js 18 ou plus). Dans le navigateur, aucun paquet n'est nécessaire : l'extrait client.js du démarrage rapide suffit.

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

Agents d'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 }));
GitHubNPM

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

Prêt à commencer ?

Créez un compte gratuit et obtenez votre clé de site en quelques secondes.

Commencer