SilentShield

Documentație pentru Dezvoltatori

Protecție invizibilă împotriva roboților. Fără CAPTCHA-uri. API-first.

Ghid rapid în 60 sObține Cheia de Site

Ghid Rapid

1

Instalare și Încorporare

Adăugați scriptul și obțineți un token

2

Verificare pe Server

Validați tokenul pe backend-ul dumneavoastră

Test Rapid cu cURL

Verificați nonce din linia de comandă

# Verificare 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);
})();

Securitate și Confidențialitate

  • Fără cookie-uri – funcționare complet fără cookie-uri
  • Fără colectare de PII – conform GDPR & CCPA
  • Găzduire în UE – toate datele rămân în Europa
  • Compatibil WCAG – accesibil tuturor utilizatorilor
  • Compatibil CSP – utilizare cu Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Referință API

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

POST/v1/verify

Verificare SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringNonce-ul de verificat

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 verificat cu succes
400Cerere invalidă (Nonce lipsă sau incorect)
401Cheie API invalidă
429Limită de rată depășită (100 cereri/min.)
500Eroare internă a serverului

SDK-uri și Biblioteci

Pachetul rulează pe serverul tău (Node.js 18 sau mai nou). În browser nu ai nevoie de niciun pachet — acolo este suficient fragmentul client.js din ghidul rapid.

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

Agenți IA (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

Resources

Help Center

Comprehensive documentation with getting started guides, integration tutorials, configuration references, and troubleshooting.

Open Help Center

Changelog

Stay up to date with the latest features, improvements, and fixes.

View Changelog

Gata de start?

Creați un cont gratuit și obțineți Cheia de Site în câteva secunde.

Începeți acum