Fejlesztői Dokumentáció

Láthatatlan botvédelem. Nincsenek CAPTCHA-k. API-központú.

Gyorsindítás 60 másodperc alatt Site Key lekérése

Gyorsindítás

Telepítés és Beágyazás

Adja hozzá a szkriptet és szerezzen tokent

Ellenőrzés Szerveren

Érvényesítse a tokent a backendjén

Gyors Teszt cURL-lel

Nonce ellenőrzése parancssorból

# Nonce ellenőrzése
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);
})();

Biztonság és Adatvédelem

Nincsenek cookie-k – teljes mértékben cookie-mentes működés
Nincs PII gyűjtés – GDPR és CCPA kompatibilis
EU hosting – minden adat Európában marad
WCAG kompatibilis – minden felhasználó számára elérhető
CSP kompatibilis – használja a Content Security Policy-vel:

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

API Referencia

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

POST/v1/verify

SilentShield Nonce ellenőrzése

Request Headers:

AuthorizationBearer YOUR_API_KEY

Content-Typeapplication/json

Request Body:

tokenstringAz ellenőrizendő Nonce

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 sikeresen ellenőrizve

400Érvénytelen kérés (hiányzó vagy hibás Nonce)

401Érvénytelen API-kulcs

429Sebességkorlát túllépve (100 kérés/perc)

500Belső szerverhiba

SDK-k és Könyvtárak

A csomag a szerveren fut (Node.js 18-tól). A böngészőben egyáltalán nincs szükség csomagra — ott elég a gyors kezdéshez tartozó client.js kódrészlet.

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

MI-ügynökök (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

Készen áll a kezdésre?

Hozzon létre ingyenes fiókot, és szerezze be Site Key-jét másodpercek alatt.

Kezdje el most