SilentShield

Dokumentácia pre vývojárov

Neviditeľná ochrana proti botom. Žiadne CAPTCHA. API-first.

Rýchly štart za 60 sZískať Site Key

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
  • Žiadne profily, žiadne cookies – použiteľné v súlade s GDPR
  • 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-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:;

Referencia API

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

POST/v1/verify

Overiť SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringNonce na overenie

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 úspešne overený
400Neplatná požiadavka (chýbajúci alebo nesprávny Nonce)
401Neplatný API kľúč
429Prekročený limit rýchlosti
500Vnútorná chyba servera

SDK a Knižnice

Balík beží na vašom serveri (Node.js od 18). V prehliadači žiadny balík nepotrebujete — tam stačí úryvok client.js z rýchleho štartu.

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 agenti (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

Zdroje

Centrum pomoci

Komplexná dokumentácia s úvodnými návodmi, integračnými tutoriálmi, referenciou konfigurácie a riešením problémov.

Otvoriť Centrum pomoci

Zoznam zmien

Buďte v obraze o najnovších funkciách, vylepšeniach a opravách.

Zobraziť zoznam zmien

Pripravení začať?

Vytvorte si bezplatný účet a získajte svoj Site Key za pár sekúnd.

Začať