Documentação para Desenvolvedores
Proteção invisível contra bots. Sem CAPTCHAs. API-first.
Início Rápido
1
Instalar e Incorporar
Adicione o script e obtenha um token
2
Verificar no Servidor
Valide o token no seu backend
Teste Rápido com cURL
Verificar nonce a partir da linha de comando
# 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);
})();Segurança e Privacidade
- Sem cookies – operação totalmente sem cookies
- Sem coleta de PII – em conformidade com GDPR e CCPA
- Hospedagem na UE – todos os dados permanecem na Europa
- Conformidade com WCAG – acessível a todos os utilizadores
- Compatível com CSP – use com Content Security Policy:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;Referência da API
API Version: 2025-10-01 · Base URL: https://api.silentshield.io
POST
/v1/verifyVerificar Nonce SilentShield
Request Headers:
AuthorizationBearer YOUR_API_KEYContent-Typeapplication/jsonRequest Body:
tokenstringO Nonce a verificarResponse:
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 com sucesso400Pedido inválido (Nonce ausente ou incorreto)401Chave API inválida429Limite de taxa excedido500Erro interno do servidorSDKs e Bibliotecas
O pacote corre no teu servidor (Node.js 18 ou superior). No navegador não precisas de pacote nenhum — aí basta o excerto client.js do arranque rápido.
Node.js / Express
v1.2.0npm i @forge12interactive/silentshield-sdk-jsimport { 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");
});Agentes de IA (Node.js)
v1.2.0npm i @forge12interactive/silentshield-sdk-jsimport { 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 }));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.