SilentShield

Dokumentazzjoni għall-Iżviluppaturi

Protezzjoni inviżibbli kontra l-bots. L-ebda CAPTCHA. API-first.

Bidu Mgħaġġel f'60 sIkseb iċ-Ċavetta tas-Sit

Bidu Mgħaġġel

1

Installa u Integra

Żid l-iskript u akkwista token

2

Ivverifika fuq is-Server

Ivvalida t-token fuq il-backend tiegħek

Test Mgħaġġel bil-cURL

Ivverifika l-nonce mil-linja tal-kmand

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

Sigurtà u Privatezza

  • Ebda cookies – tħaddim kompletament mingħajr cookies
  • Ebda ġbir ta' PII – konformi mal-GDPR u s-CCPA
  • Hosting fl-UE – id-dejta kollha tibqa' fl-Ewropa
  • Konformi ma' WCAG – aċċessibbli għall-utenti kollha
  • Konformi ma' CSP – uża ma' Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Referenza tal-API

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

POST/v1/verify

Ivverifika SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringNonce li għandu jiġi vverifikat

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 ġie vverifikat b'suċċess
400Talba invalida (Nonce nieqes jew żbaljat)
401Ċavetta tal-API invalida
429Il-limitu tar-rata nqabeż (100 talba/min.)
500Żball intern tas-server

SDKs u Libreriji

Il-pakkett jaħdem fuq is-server tiegħek (Node.js 18 jew aktar). Fil-browser ma għandekx bżonn pakkett — hemm biżżejjed is-snippet client.js mill-bidu mgħaġġel.

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

Aġenti tal-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

Lest biex tibda?

Oħloq kont b'xejn u akkwista ċ-ċavetta tas-sit tiegħek fi ftit sekondi.

Ibda issa