SilentShield

Dokumentacja dla Programistów

Niewidoczna ochrona przed botami. Bez CAPTCHA. API-first.

Szybki start w 60 sPobierz Klucz Witryny

Szybki Start

1

Instalacja i Osadzanie

Dodaj skrypt i uzyskaj token

2

Weryfikacja na Serwerze

Weryfikuj token na swoim backendzie

Szybki Test z cURL

Weryfikuj nonce z wiersza poleceń

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

Bezpieczeństwo i Prywatność

  • Bez plików cookie – działanie całkowicie bez plików cookie
  • Brak zbierania PII – zgodne z RODO i CCPA
  • Hosting w UE – wszystkie dane pozostają w Europie
  • Zgodne z WCAG – dostępne dla wszystkich użytkowników
  • Kompatybilne z CSP – użycie z Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Referencja API

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

POST/v1/verify

Weryfikuj SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringNonce do weryfikacji

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 pomyślnie zweryfikowany
400Nieprawidłowe żądanie (brakujące lub nieprawidłowe Nonce)
401Nieprawidłowy klucz API
429Przekroczony limit zapytań
500Wewnętrzny błąd serwera

SDK i Biblioteki

Pakiet działa na twoim serwerze (Node.js od 18). W przeglądarce nie potrzebujesz żadnego pakietu — tam wystarczy fragment client.js z szybkiego startu.

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

Agenci SI (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

Gotowy do rozpoczęcia?

Utwórz darmowe konto i uzyskaj klucz witryny w kilka sekund.

Rozpocznij teraz