Byebot - Flask Example

A Flask application demonstrating Byebot integration.

Installation

pip install -r requirements.txt

Configuration

Edit the values at the top of app.py:

BYEBOT_API_KEY = "your-api-key"
BYEBOT_SITE_KEY = "your-site-key"

Usage

python app.py

Visit http://localhost:5000

How It Works

1. Frontend: The widget is loaded via <script src="https://challenge.byebot.de/ray/widget.js">. A div with class="captcha-widget" and data-sitekey attribute renders the CAPTCHA.

2. Token Submission: On verification, the widget adds a hidden byebot-token field to the form.

3. Server Validation: POST the token to /validate_token:

response = requests.post(
    "https://challenge.byebot.de/validate_token",
    json={"api_key": BYEBOT_API_KEY, "token": token}
)
# 200 OK = valid token

Files

• app.py - Flask server with form handling and token validation
• templates/index.html - Login form with CAPTCHA widget
• templates/result.html - Success page