開発者ドキュメント

目に見えないボット保護。CAPTCHAなし。APIファースト。

60秒でクイックスタートサイトキーを取得

クイックスタート

インストールと埋め込み

スクリプトを追加してトークンを取得

サーバー側で検証

バックエンドでトークンを検証

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

セキュリティとプライバシー

Cookieなし – 完全にCookieフリーでの動作
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");
});

GitHub NPM

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

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

始める準備はできましたか？

無料アカウントを作成して、数秒でサイトキーを取得してください。

始める