SilentShield

Documentación para Desarrolladores

Protección invisible contra bots. Sin CAPTCHAs. API-first.

Inicio rápido en 60 sObtener Clave de Sitio

Inicio Rápido

1

Instalar e Incrustar

Añada el script y obtenga un token

2

Verificar en el Servidor

Valide el token en su backend

Prueba Rápida con cURL

Verificar nonce desde la línea de comandos

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

Seguridad y Privacidad

  • Sin cookies – funcionamiento completamente sin cookies
  • Sin recopilación de PII – conforme a GDPR y CCPA
  • Alojamiento en la UE – todos los datos permanecen en Europa
  • Conforme a WCAG – accesible para todos los usuarios
  • Compatible con CSP – usar con Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

Referencia de la API

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

POST/v1/verify

Verificar Nonce SilentShield

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstringEl Nonce a verificar

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 verificado con éxito
400Solicitud no válida (nonce faltante o incorrecto)
401Clave API no válida
429Límite de tasa excedido
500Error interno del servidor

SDKs y Bibliotecas

El paquete se ejecuta en tu servidor (Node.js 18 o superior). En el navegador no necesitas ningún paquete: allí basta con el fragmento client.js del inicio rápido.

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

Agentes de IA (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 }));
GitHubNPM

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

¿Listo para empezar?

Crea una cuenta gratuita y obtén tu clave de sitio en segundos.

Empezar