Class TencentCaptchaClient

app/clients/tencent_captcha_client.py:46–204

Fetch Tencent captcha challenge metadata and image bytes.

    randstr: str
    ret: Any
    error_code: str
    error_message: str
    sess: str
    raw: dict[str, Any]


class TencentCaptchaClient:
    """Fetch Tencent captcha challenge metadata and image bytes."""

    def __init__(
        self,
        http_client: FingerprintHttpClient | None = None,
        settings: Settings | None = None,
    ) -> None:
        self.settings = settings or get_settings()
        self.http_client = http_client or FingerprintHttpClient(self.settings)

    def prehandle(self, account: AccountRecord) -> CaptchaChallenge:
        callback = f"_aq_{int(time.time() * 1000)}"
        user_agent = resolve_user_agent(account.user_agent, account.browser_impersonate)
        response_text = self.http_client.request_text(
            "GET",
            f"{self.settings.tencent_captcha_domain}/cap_union_prehandle",
            headers={
                "Accept": "*/*",
                "Referer": self.settings.tencent_captcha_entry_url,
            },
            params={
                "aid": self.settings.tencent_captcha_aid,
                "protocol": "https",
                "accver": "1",
                "showtype": "popup",
                "ua": base64.b64encode(user_agent.encode("utf-8")).decode("ascii"),
                "noheader": "0",
                "fb": "1",
                "aged": "0",
                "enableAged": "0",
                "enableDarkMode": "0",
                "grayscale": "1",
                "clientype": "2",
                "lang": "zh-cn",
                "entry_url": self.settings.tencent_captcha_entry_url,
                "elder_captcha": "0",
                "js": "",
                "login_appid": "",
                "wb": "1",
                "subsid": "1",
                "callback": callback,
                "sess": "",
            },
            proxy_url=account.proxy_url or None,
            user_agent=user_agent,
            browser_impersonate=account.browser_impersonate or None,
        )
        payload = self._parse_jsonp(response_text)
        image_path = str(
            (((payload.get("data") or {}).get("dyn_show_info") or {}).get("bg_elem_cfg") or {}).get("img_url")
            or ""