Turnstile in Python

import os
from typing import Any

import requests

API_URL = "https://api.uncaptcha.io/v1/task/execute"


class UncaptchaError(RuntimeError):
    pass


def solve_turnstile(
    *,
    url: str,
    sitekey: str,
    proxy: str | None = None,
    action: str | None = None,
    cdata: str | None = None,
) -> str:
    task_data: dict[str, Any] = {
        "url": url,
        "sitekey": sitekey,
    }
    if proxy:
        task_data["proxy"] = proxy
    if action:
        task_data["action"] = action
    if cdata:
        task_data["cdata"] = cdata

    response = requests.post(
        API_URL,
        headers={"X-Api-Key": os.environ["UNCAPTCHA_API_KEY"]},
        json={"task_type": "turnstile", "task_data": task_data},
        timeout=35,
    )

    try:
        payload = response.json()
    except requests.JSONDecodeError as exc:
        raise UncaptchaError(
            f"uncaptcha.io returned non-JSON status {response.status_code}"
        ) from exc

    if not response.ok or not payload.get("success"):
        message = payload.get("message", "unknown uncaptcha.io error")
        raise UncaptchaError(f"{response.status_code}: {message}")

    return payload["data"]["solution"]["token"]


if __name__ == "__main__":
    token = solve_turnstile(
        url="https://example.com/register",
        sitekey="0x4AAAAAABs37s-ih7Jepz0J",
        proxy=os.getenv("SOLVE_PROXY"),
        action="register",
    )
    print(token)