Class CapmonsterClient

src/capmonster_python/client.py:12–363

class CapmonsterClient:
    __BASE_URL = "https://api.capmonster.cloud"
    __BALANCE_URL = "/getBalance"
    __TASK_RESULT_URL = "/getTaskResult"
    __CREATE_TASK_URL = "/createTask"

    __REPORT_IMAGE_URL = "/reportIncorrectImageCaptcha"
    __REPORT_TOKEN_URL = "/reportIncorrectTokenCaptcha"
    __USER_AGENT_URL = "https://capmonster.cloud/api/useragent/actual"

    def __init__(self, api_key: str, timeout: Optional[float] = 30.0,
                 max_retries: int = 120, retry_delay: float = 2.0) -> None:
        self.api_key = api_key
        self.__max_retries = max_retries
        self.__retry_delay = retry_delay
        self.__async_client = AsyncClient(timeout=timeout, base_url=self.__BASE_URL)
        self.__sync_client = Client(timeout=timeout, base_url=self.__BASE_URL)

    def __enter__(self) -> "CapmonsterClient":
        return self

    def __exit__(self, *args) -> None:
        self.__sync_client.close()

    async def __aenter__(self) -> "CapmonsterClient":
        return self

    async def __aexit__(self, *args) -> None:
        await self.__async_client.aclose()

    def get_balance(self) -> float:
        """
        Fetches the current balance using the provided API key.

        Raises:
            This method may raise exceptions if the HTTP request fails or the JSON response
            format is unexpected. These exceptions are not handled within the method.

        Returns:
            float: The balance fetched from the external service. Defaults to 0.0 if the balance
            key is not found in the response.
        """
        payload = GetBalancePayload(clientKey=self.api_key).model_dump()
        response = self.__make_sync_request(self.__BALANCE_URL, payload).json()
        return response.get("balance", 0.0)

    async def get_balance_async(self) -> float:
        """
        Asynchronously fetches the current balance using the provided API key.

        Raises:
            This method may raise exceptions if the HTTP request fails or the JSON response
            format is unexpected. These exceptions are not handled within the method.

        Returns:
            float: The balance fetched from the external service. Defaults to 0.0 if the balance
            key is not found in the response.
        """