Utvecklardokumentation
Osynligt botskydd. Inga CAPTCHA. API-first.
Snabbstart
1
Installera och Bädda in
Lägg till skriptet och få en token
2
Verifiera på Server
Validera token på din backend
Snabbt Test med cURL
Verifiera nonce från kommandoraden
# Verifiera 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äkerhet och Integritet
- Inga cookies – helt cookie-fri drift
- Ingen insamling av PII – GDPR- & CCPA-kompatibel
- EU-hosting – all data stannar i Europa
- WCAG-kompatibel – tillgänglig för alla användare
- CSP-kompatibel – använd med Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;API-referens
API Version: 2025-10-01 · Base URL: https://api.silentshield.io
POST
/v1/verifyVerifiera SilentShield Nonce
Request Headers:
AuthorizationBearer YOUR_API_KEYContent-Typeapplication/jsonRequest Body:
tokenstringDen nonce som ska verifierasResponse:
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 framgångsrikt verifierad400Ogiltig förfrågan (nonce saknas eller är felaktig)401Ogiltig API-nyckel429Hastighetsgräns överskriden (100 förfrågningar/min)500Internt serverfelSDK:er och Bibliotek
Paketet körs på din server (Node.js 18 eller senare). I webbläsaren behöver du inget paket alls — där räcker client.js-utdraget från snabbstarten.
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-agenter (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 }));Resources
Help Center
Comprehensive documentation with getting started guides, integration tutorials, configuration references, and troubleshooting.
Changelog
Stay up to date with the latest features, improvements, and fixes.