Dokumentacja dla Programistów

Niewidoczna ochrona przed botami. Bez CAPTCHA. API-first.

Szybki start w 60 s Pobierz Klucz Witryny

Szybki Start

Instalacja i Osadzanie

Dodaj skrypt i uzyskaj token

Weryfikacja na Serwerze

Weryfikuj token na swoim backendzie

Szybki Test z cURL

Weryfikuj nonce z wiersza poleceń

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

Bezpieczeństwo i Prywatność

Bez plików cookie – działanie całkowicie bez plików cookie
Brak zbierania PII – zgodne z RODO i CCPA
Hosting w UE – wszystkie dane pozostają w Europie
Zgodne z WCAG – dostępne dla wszystkich użytkowników
Kompatybilne z CSP – użycie z Content Security Policy:

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

Referencja API

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

POST/v1/verify

Weryfikuj SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY

Content-Typeapplication/json

Request Body:

tokenstringNonce do weryfikacji

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 pomyślnie zweryfikowany

400Nieprawidłowe żądanie (brakujące lub nieprawidłowe Nonce)

401Nieprawidłowy klucz API

429Przekroczony limit zapytań (100 zapytań/min.)

500Wewnętrzny błąd serwera

SDK i Biblioteki

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

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

Gotowy do rozpoczęcia?

Utwórz darmowe konto i uzyskaj klucz witryny w kilka sekund.

Rozpocznij teraz