Dokumentazzjoni għall-Iżviluppaturi

Protezzjoni inviżibbli kontra l-bots. L-ebda CAPTCHA. API-first.

Bidu Mgħaġġel f'60 s Ikseb iċ-Ċavetta tas-Sit

Bidu Mgħaġġel

Installa u Integra

Żid l-iskript u akkwista token

Ivverifika fuq is-Server

Ivvalida t-token fuq il-backend tiegħek

Test Mgħaġġel bil-cURL

Ivverifika l-nonce mil-linja tal-kmand

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

Sigurtà u Privatezza

Ebda cookies – tħaddim kompletament mingħajr cookies
Ebda ġbir ta' PII – konformi mal-GDPR u s-CCPA
Hosting fl-UE – id-dejta kollha tibqa' fl-Ewropa
Konformi ma' WCAG – aċċessibbli għall-utenti kollha
Konformi ma' CSP – uża ma' Content Security Policy:

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

Referenza tal-API

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

POST/v1/verify

Ivverifika SilentShield Nonce

Request Headers:

AuthorizationBearer YOUR_API_KEY

Content-Typeapplication/json

Request Body:

tokenstringNonce li għandu jiġi vverifikat

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 ġie vverifikat b'suċċess

400Talba invalida (Nonce nieqes jew żbaljat)

401Ċavetta tal-API invalida

429Il-limitu tar-rata nqabeż (100 talba/min.)

500Żball intern tas-server

SDKs u Libreriji

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

// Verifika tal-Formola
const result = await backend.verifyFormSubmission(formData);
if (result.isValid) {
  console.log('Bniedem ivverifikat!', 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();
      // Issottometti bit-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();
    // Issottometti bit-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

Lest biex tibda?

Oħloq kont b'xejn u akkwista ċ-ċavetta tas-sit tiegħek fi ftit sekondi.

Ibda issa