EU CAPTCHA for Python

Frequently Asked Questions

• How do I verify a CAPTCHA token in Python?

  Install the EU CAPTCHA Python module via pip. In your request handler, extract the eu-captcha-response token from the POST data, then call the verification method with your secret key and the token. The module sends the request to the EU CAPTCHA API and returns a result indicating whether the interaction was human or automated.

• Does EU CAPTCHA work with Flask?

  Yes. In a Flask view function, access the eu-captcha-response token from request.form, call the EU CAPTCHA Python client to verify it, and either proceed with form processing or return an error response. You can also create a Flask decorator that wraps your view functions to perform the verification check before the view logic runs.

• How do I integrate EU CAPTCHA with FastAPI?

  In a FastAPI endpoint, include the eu-captcha-response as a Form field in your request model or read it directly from the form data. Call the EU CAPTCHA Python client to verify the token. For async FastAPI applications, use an async HTTP client like httpx in the verification call, or run the synchronous client in a thread pool using run_in_executor.

• Is there an official Python module for EU CAPTCHA?

  Yes. EU CAPTCHA provides an official Python client library installable via pip. The module encapsulates the API call, handles authentication with your secret key, and parses the verification response. It is compatible with Python 3.8 and later and works with all major Python web frameworks including Flask, FastAPI, and Django.

• Can EU CAPTCHA be used with Django?

  Yes. EU CAPTCHA provides a dedicated Django module that integrates with Django's form validation pipeline. Install it via pip, add it to INSTALLED_APPS, configure your sitekey and secret key in settings.py, and use the provided form field or template tag in your Django forms and templates.

• How do I handle CAPTCHA token validation errors in Python?

  The EU CAPTCHA Python client raises an exception or returns an error response when verification fails. Handle this in a try-except block and return an appropriate HTTP error response to the client — typically a 400 or 422 status code. For network errors reaching the EU CAPTCHA API, the failsafe mode allows submissions to proceed so your application stays available.

• Is EU CAPTCHA GDPR compliant for Python web applications?

  Yes. EU CAPTCHA is operated by an EU-based company, is hosted entirely in Germany, and does not rely on US cloud providers or infrastructure subject to US surveillance laws. The service processes only the data necessary to provide and verify the CAPTCHA (such as IP address and technical browser or device information) in line with the requirements of the GDPR. Your organization remains responsible for providing transparent privacy information, selecting an appropriate legal basis, and obtaining any required consent for your specific Python implementation. This information does not constitute legal advice; please consult your legal counsel for an assessment of your individual case.