Dokumentácia pre Vývojárov
Neviditeľná ochrana proti botom. Žiadne CAPTCHA. API-first.
Rýchly Štart
1
Inštalácia a Vloženie
Pridajte skript a získajte token
2
Overenie na Serveri
Overte token na vašom backende
Rýchly Test s cURL
Overenie nonce z príkazového riadku
# Overiť 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);
})();Bezpečnosť a Súkromie
- Žiadne cookies – prevádzka úplne bez cookies
- Žiadny zber PII – v súlade s GDPR a CCPA
- EU hosting – všetky dáta zostávajú v Európe
- WCAG kompatibilné – prístupné pre všetkých používateľov
- CSP kompatibilné – použitie s Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;Referencia API
API Version: 2025-10-01 · Base URL: https://api.silentshield.io
POST
/v1/verifyOveriť SilentShield Nonce
Request Headers:
AuthorizationBearer YOUR_API_KEYContent-Typeapplication/jsonRequest Body:
tokenstringNonce na overenieResponse:
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 úspešne overený400Neplatná požiadavka (chýbajúci alebo nesprávny Nonce)401Neplatný API kľúč429Prekročený limit rýchlosti500Vnútorná chyba serveraSDK a Knižnice
Balík beží na tvojom serveri (Node.js od 18). V prehliadači žiadny balík nepotrebuješ — tam stačí úryvok client.js z rýchleho štartu.
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 agenti (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.