SilentShield

Kehittäjän dokumentaatio

Näkymätön bottisuojaus. Ei CAPTCHA-kyselyitä. API-etupäässä.

60 s pika-aloitusHae Sivainavain

Pika-aloitus

1

Asenna ja Integroi

Lisää skripti ja hanki tunniste (token)

2

Varmenna Palvelimella

Validoi tunniste taustaohjelmassasi

Nopea Testaus cURL:llä

Varmenna tunnus (nonce) komentoriviltä

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

Turvallisuus & Yksityisyys

  • Ei evästeitä – täysin evästeetön toiminta
  • Ei PII-keräystä – GDPR & CCPA -yhteensopiva
  • EU-hosting – kaikki data pysyy Euroopassa
  • WCAG-yhteensopiva – kaikkien käyttäjien saavutettavissa
  • CSP-yhteensopiva – käytä Content Security Policyn kanssa:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

API-viite

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

POST/v1/verify

Varmenna SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringVarmennettava tunnus (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:

200Tunnus (nonce) varmennettu onnistuneesti
400Virheellinen pyyntö (puuttuva tai väärä tunnus)
401Virheellinen API-avain
429Nopeusrajoitus ylitetty (100 pyyntöä/min.)
500Sisäinen palvelinvirhe

SDK:t ja Kirjastot

Paketti toimii palvelimellasi (Node.js 18 tai uudempi). Selaimessa et tarvitse pakettia lainkaan — siellä riittää pikaoppaan client.js-katkelma.

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

Tekoälyagentit (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

Oletko valmis aloittamaan?

Luo ilmainen tili ja hanki sivainavain muutamassa sekunnissa.

Aloita nyt