連携ガイド

クイックスタート

BotFlush は、ウィジェットの読み込み、表示、サーバー側トークン検証の 3 手順で連携できます。

1. ウィジェットを読み込む

ページにウィジェットスクリプトを追加します。非同期で読み込まれ、描画をブロックしません。

<script src="https://challenge.botflush.com/widget.js" async defer></script>

2. コンテナを追加

CAPTCHA を表示したい場所にコンテナ要素を置きます。

<div id="bf-captcha" data-sitekey="YOUR_SITE_KEY"></div>

3. サーバー側で検証

ユーザーがチャレンジを完了するとトークンが生成されます。サーバーに送信して API で検証します。

POST https://challenge.botflush.com/api/siteverify
Content-Type: application/json

{
  "secret": "YOUR_SECRET_KEY",
  "token": "TOKEN_FROM_CLIENT"
}

JavaScript API

BotFlush.render()

BotFlush.render('bf-captcha', {
  siteKey: 'YOUR_SITE_KEY',
  callback: function(token) {
    console.log('Verified:', token);
  }
});

BotFlush.reset()

BotFlush.reset();

BotFlush.getResponse()

var token = BotFlush.getResponse();

移行メモ

BotFlush は一般的な widget と siteverify パターンをサポートします。script URL、キー、検証エンドポイントを変更し、展開前に callback とエラー処理を確認してください。

<!-- Before -->
<script src="https://www.google.com/recaptcha/api.js"></script>
<div class="g-recaptcha" data-sitekey="GOOGLE_KEY"></div>

<!-- After -->
<script src="https://challenge.botflush.com/widget.js"></script>
<div class="g-recaptcha" data-sitekey="BOTFLUSH_KEY"></div>

プライバシー管理

BotFlush is designed around minimized data use, account-level controls, and enterprise review workflows. The console remains the source of truth for currently available privacy and data controls.

検証モード

BotFlush は複数のチャレンジエンジンを提供します。サイトごとに許可するエンジンをコンソールで設定できます。

サーバー検証

Node.js

const res = await fetch('https://challenge.botflush.com/api/siteverify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ secret, token })
});

Python

resp = requests.post('https://challenge.botflush.com/api/siteverify', json={
    'secret': BOTFLUSH_SECRET,
    'token': token
})

Go

resp, _ := http.Post("https://challenge.botflush.com/api/siteverify",
    "application/json", bytes.NewBuffer(payload))

ダウンロード

Node Inspector — Chrome 拡張

インストール: ダウンロードして展開し、Chrome の拡張機能画面でデベロッパー モードを有効にして、展開したフォルダーを読み込みます。