Dokumentace pro Vývojáře

Neviditelná ochrana proti botům. Žádné CAPTCHA. API-first.

Rychlý start za 60 s Získat Site Key

Rychlý Start

Instalace a Vložení

Přidejte skript a získejte token

Ověření na Serveru

Ověřte token na vašem backendu

Rychlý Test s cURL

Ověření nonce z příkazového řádku

# Ověřit 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);
})();

Zabezpečení a Soukromí

Žádné cookies – provoz zcela bez cookies
Žádný sběr PII – v souladu s GDPR a CCPA
EU hosting – všechna data zůstávají v Evropě
WCAG kompatibilní – přístupné všem uživatelům
CSP kompatibilní – použití s Content Security Policy:

Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Referenční příručka API

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

POST/v1/verify

Ověřit SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY

Content-Typeapplication/json

Request Body:

tokenstringNonce k ověření

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 úspěšně ověřen

400Neplatný požadavek (chybějící nebo nesprávný Nonce)

401Neplatný API klíč

429Překročen limit rychlosti (100 požadavků/min.)

500Interní chyba serveru

SDK a Knihovny

Balíček běží na tvém serveru (Node.js od verze 18). V prohlížeči žádný balíček nepotřebuješ — tam stačí úryvek client.js z rychlého 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");
});

GitHub NPM

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 }));

GitHub NPM

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

Jste připraveni začít?

Vytvořte si bezplatný účet a získejte svůj Site Key během několika sekund.

Začněte nyní