Τεκμηρίωση Προγραμματιστών

Αόρατη προστασία από bots. Χωρίς CAPTCHAs. API-first.

Γρήγορη Εκκίνηση

1

Εγκατάσταση & Ενσωμάτωση

Προσθέστε το script και λάβετε ένα token

2

Επαλήθευση στον Server

Επικυρώστε το token στο backend σας

Γρήγορη Δοκιμή με cURL

Επαληθεύστε το nonce από τη γραμμή εντολών

# Επαλήθευση 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);
})();

Ασφάλεια & Απόρρητο

  • Χωρίς cookies – πλήρως λειτουργία χωρίς cookies
  • Καμία συλλογή PII – συμβατό με GDPR & CCPA
  • Φιλοξενία στην ΕΕ – όλα τα δεδομένα παραμένουν στην Ευρώπη
  • Συμβατό με WCAG – προσβάσιμο σε όλους τους χρήστες
  • Συμβατό με CSP – χρήση με Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Αναφορά API

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

POST/v1/verify

Επαλήθευση SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringΤο 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 επαληθεύτηκε επιτυχώς
400Μη έγκυρη αίτηση (λείπει ή είναι λανθασμένο το Nonce)
401Μη έγκυρο Κλειδί API
429Υπέρβαση ορίου ρυθμού
500Εσωτερικό σφάλμα διακομιστή

SDKs & Βιβλιοθήκες

Το πακέτο τρέχει στον διακομιστή σου (Node.js από 18 και πάνω). Στο πρόγραμμα περιήγησης δεν χρειάζεσαι κανένα πακέτο — εκεί αρκεί το απόσπασμα client.js από τον γρήγορο οδηγό.

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

Πράκτορες ΤΝ (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.

Είστε έτοιμοι να ξεκινήσετε;

Δημιουργήστε έναν δωρεάν λογαριασμό και λάβετε το κλειδί της ιστοσελίδας σας σε δευτερόλεπτα.