SilentShield

개발자 문서

투명한 봇 보호. CAPTCHA 없음. API 우선.

60초 퀵스타트사이트 키 받기

퀵스타트

1

설치 및 포함

스크립트를 추가하고 토큰 받기

2

서버에서 확인

백엔드에서 토큰 유효성 검사

cURL로 빠른 테스트

명령줄에서 Nonce 확인

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

보안 및 개인 정보 보호

  • 쿠키 없음 – 완전히 쿠키 없는 작동
  • PII(개인 식별 정보) 수집 없음 – GDPR 및 CCPA 준수
  • EU 호스팅 – 모든 데이터는 유럽에 보관
  • WCAG 준수 – 모든 사용자가 접근 가능
  • CSP 호환 – Content Security Policy와 함께 사용:
Content-Security-Policy: script-src 'self' https://api.silentshield.io;

API 참조

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

POST/v1/verify

SilentShield Nonce 확인

Request Headers:

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body:

tokenstring확인할 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 성공적으로 확인됨
400잘못된 요청 (Nonce 누락 또는 오류)
401잘못된 API 키
429요청 속도 제한 초과 (100 요청/분)
500내부 서버 오류

SDK 및 라이브러리

이 패키지는 서버에서 동작합니다(Node.js 18 이상). 브라우저에서는 패키지가 전혀 필요 없으며, 빠른 시작의 client.js 스니펫이면 충분합니다.

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

AI 에이전트 (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

시작할 준비가 되셨나요?

무료 계정을 만들고 몇 초 만에 사이트 키를 받으세요.

시작하기