Izstrādātāja Dokumentācija

Neredzamā botu aizsardzība. Bez CAPTCHA. API-pirmais.

Ātrais Sākums

1

Instalēt un Integrēt

Pievienojiet skriptu un saņemiet pilnvaru (token)

2

Pārbaudīt Serverī

Apstipriniet pilnvaru savā aizmugursistēmā (backend)

Ātrais Tests ar cURL

Pārbaudiet nonce no komandrindas

# Pārbaudīt 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);
})();

Drošība un Privātums

  • Bez sīkdatnēm – pilnīga darbība bez sīkdatnēm
  • PII vākšana netiek veikta – atbilst GDPR un CCPA
  • ES mitināšana (hosting) – visi dati paliek Eiropā
  • WCAG saderīgs – pieejams visiem lietotājiem
  • CSP saderīgs – izmantojiet ar satura drošības politiku (Content Security Policy):
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

API Atsauce

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

POST/v1/verify

Pārbaudīt SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringPārbaudāmais 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 veiksmīgi pārbaudīts
400Nederīgs pieprasījums (trūkst vai ir nepareizs Nonce)
401Nederīga API atslēga
429Pārsniegts pieprasījumu limits (100 pieprasījumi/min.)
500Iekšēja servera kļūda

SDK un Bibliotēkas

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();

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();

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');

// Formas pārbaude
const result = await backend.verifyFormSubmission(formData);
if (result.isValid) {
  console.log('Cilvēks pārbaudīts!', result.formData);
}

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();
      // Iesniegt ar pilnvaru
    }
  }
};

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();
    // Iesniegt ar pilnvaru
  };
  
  return <form onSubmit={handleSubmit}>...</form>;
}

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.

Gatavs sākt?

Izveidojiet bezmaksas kontu un saņemiet savu vietnes atslēgu dažu sekunžu laikā.

Sākt tagad