Entwickler-Dokumentation

Unsichtbarer Bot-Schutz. Keine CAPTCHAs. API-first.

Quickstart in 60 s Site Key abrufen

Quickstart

Installieren & Einbetten

Fügen Sie das Skript hinzu und erhalten Sie ein Token

Auf dem Server verifizieren

Validieren Sie das Token in Ihrem Backend

Schnelltest mit cURL

Token über die Kommandozeile verifizieren

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

Sicherheit & Datenschutz

Keine Cookies – vollständig ohne Cookies
Keine Erfassung personenbezogener Daten (PII) – DSGVO- & CCPA-konform
EU-Hosting – alle Daten bleiben in Europa
WCAG-konform – für alle Benutzer zugänglich
CSP-kompatibel – Verwendung mit Content Security Policy:

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

API-Referenz

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

POST/v1/verify

SilentShield-Nonce verifizieren

Request Headers:

AuthorizationBearer YOUR_API_KEY

Content-Typeapplication/json

Request Body:

tokenstringDas zu verifizierende 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 erfolgreich verifiziert

400Ungültige Anfrage (fehlendes oder fehlerhaftes Nonce)

401Ungültiger API-Schlüssel

429Rate-Limit überschritten (100 Anfragen/Min.)

500Interner Server-Fehler

SDKs & Bibliotheken

JavaScript ES6+

v1.0.1

npm i @forge12interactive/silentshield-sdk-js

import { SilentShield } from "@forge12interactive/silentshield-sdk-js";

const shield = new SilentShield({
  siteKey: 'your-site-key',
  debug: true
});

await shield.initialize();
const token = await shield.getToken();

GitHub NPM

TypeScript

v1.0.1

npm i @forge12interactive/silentshield-sdk-js

import { SilentShield, type SilentShieldConfig } from "@forge12interactive/silentshield-sdk-js";

const config: SilentShieldConfig = {
  siteKey: 'your-site-key',
  timeout: 10000
};

const shield = new SilentShield(config);
const token: string = await shield.getToken();

GitHub NPM

Node.js Backend

v1.0.1

npm i @forge12interactive/silentshield-sdk-js

import { SilentShieldBackend } from "@forge12interactive/silentshield-sdk-js";

const backend = new SilentShieldBackend('your-secret-key');

// Form verification
const result = await backend.verifyFormSubmission(formData);
if (result.isValid) {
  console.log('Human verified!', result.formData);
}

GitHub NPM

Vue.js

v1.0.1

npm i @forge12interactive/silentshield-sdk-js

import { SilentShield } from "@forge12interactive/silentshield-sdk-js";

export default {
  async mounted() {
    this.shield = new SilentShield({ siteKey: 'your-key' });
    await this.shield.initialize();
  },
  
  methods: {
    async handleSubmit() {
      const token = await this.shield.getToken();
      // Submit with token
    }
  }
};

GitHub NPM

React

v1.0.1

npm i @forge12interactive/silentshield-sdk-js

import { SilentShield } from "@forge12interactive/silentshield-sdk-js";
import { useEffect, useState } from 'react';

function MyForm() {
  const [shield, setShield] = useState(null);
  
  useEffect(() => {
    const init = async () => {
      const s = new SilentShield({ siteKey: 'your-key' });
      await s.initialize();
      setShield(s);
    };
    init();
  }, []);
  
  const handleSubmit = async (e) => {
    const token = await shield?.getToken();
    // Submit with token
  };
  
  return <form onSubmit={handleSubmit}>...</form>;
}

GitHub NPM

Ressourcen

Help Center

Umfassende Dokumentation mit Erste-Schritte-Anleitungen, Integrations-Tutorials, Konfigurations-Referenzen und Fehlerbehebung.

Help Center öffnen

Änderungsprotokoll

Bleiben Sie auf dem Laufenden über die neuesten Features, Verbesserungen und Fixes.

Changelog anzeigen

Bereit zum Start?

Erstellen Sie ein kostenloses Konto und erhalten Sie Ihren Site Key in Sekunden.

Jetzt starten