Ontwikkelaarsdocumentatie
Onzichtbare botbeveiliging. Geen CAPTCHA's. API-first.
Snelstart
Installeren & insluiten
Voeg het script toe en ontvang een token
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
/v1/verifySilentShield Nonce verifiëren
Request Headers:
AuthorizationBearer YOUR_API_KEYContent-Typeapplication/jsonRequest Body:
tokenstringDe te verifiëren NonceResponse:
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 geverifieerd400Ongeldig verzoek (ontbrekende of onjuiste Nonce)401Ongeldige API-sleutel429Rate-limiet overschreden500Interne ServerfoutSDK'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.0npm i @forge12interactive/silentshield-sdk-jsimport { 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.0npm i @forge12interactive/silentshield-sdk-jsimport { 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.