SilentShield

Ontwikkelaarsdocumentatie

Onzichtbare botbeveiliging. Geen CAPTCHA's. API-first.

Quickstart in 60 sSite Key ophalen

Quickstart

1

Installeren & Invoegen

Voeg het script toe en ontvang een token

2

Verifiëren op Server

Valideer de token op uw backend

Snelle Test met cURL

Nonce verifiëren via de commandoregel

# Nonce verifiëren
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);
})();

Beveiliging & Privacy

  • Geen cookies – volledig cookieloze werking
  • Geen verzameling van PII – AVG & CCPA compliant
  • EU-hosting – alle data blijft in Europa
  • WCAG-conform – toegankelijk voor alle gebruikers
  • CSP-compatibel – gebruik met Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

API-referentie

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

POST/v1/verify

SilentShield Nonce verifiëren

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringDe te verifiëren Nonce

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 succesvol geverifieerd
400Ongeldig verzoek (ontbrekende of onjuiste Nonce)
401Ongeldige API-sleutel
429Rate-limiet overschreden
500Interne Serverfout

SDK's & Bibliotheken

Het pakket draait op je server (Node.js 18 of nieuwer). In de browser heb je helemaal geen pakket nodig — daar volstaat het client.js-fragment uit de snelstart.

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

AI-agents (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

Klaar om te starten?

Maak een gratis account aan en ontvang uw Site Key binnen enkele seconden.

Nu starten