Ontwikkelaarsdocumentatie

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

Snelstart

1

Installeren & insluiten

Voeg het script toe en ontvang een token

2

Verifiëren op de 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 profielen, geen cookies – AVG-conform inzetbaar
  • 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-us.silentshield.io https://api-eu.silentshield.io; connect-src 'self' https://api-us.silentshield.io https://api-eu.silentshield.io; worker-src 'self' blob:;

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 uw server (Node.js 18 of nieuwer). In de browser hebt u 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");
});

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

Bronnen

Helpcentrum

Uitgebreide documentatie met handleidingen om aan de slag te gaan, integratietutorials, configuratiereferenties en probleemoplossing.

Wijzigingslogboek

Blijf op de hoogte van de nieuwste functies, verbeteringen en oplossingen.

Klaar om te starten?

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