Izstrādātāja Dokumentācija

Neredzamā botu aizsardzība. Bez CAPTCHA. API-pirmais.

Ātrais Sākums

1

Instalēt un Integrēt

Pievienojiet skriptu un saņemiet pilnvaru (token)

2

Pārbaudīt Serverī

Apstipriniet pilnvaru savā aizmugursistēmā (backend)

Ātrais Tests ar cURL

Pārbaudiet nonce no komandrindas

# Pārbaudīt 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);
})();

Drošība un Privātums

  • Bez sīkdatnēm – pilnīga darbība bez sīkdatnēm
  • PII vākšana netiek veikta – atbilst GDPR un CCPA
  • ES mitināšana (hosting) – visi dati paliek Eiropā
  • WCAG saderīgs – pieejams visiem lietotājiem
  • CSP saderīgs – izmantojiet ar satura drošības politiku (Content Security Policy):
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

API Atsauce

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

POST/v1/verify

Pārbaudīt SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringPārbaudāmais 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 veiksmīgi pārbaudīts
400Nederīgs pieprasījums (trūkst vai ir nepareizs Nonce)
401Nederīga API atslēga
429Pārsniegts pieprasījumu limits
500Iekšēja servera kļūda

SDK un Bibliotēkas

Pakotne darbojas tavā serverī (Node.js no 18). Pārlūkā pakotne nav vajadzīga vispār — tur pietiek ar ātrās darba sākšanas client.js fragmentu.

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

MI aģenti (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 }));

Resources

Help Center

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

Changelog

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

Gatavs sākt?

Izveidojiet bezmaksas kontu un saņemiet savu vietnes atslēgu dažu sekunžu laikā.