Method create_task

src/capmonster_python/client.py:74–97

Creates a task based on the provided payload and returns the task ID. This method is responsible for initiating a task by preparing the request with the provided task details and optional callback URL, sending a synchronous request to the task creation endpoint, and

(self, task: TaskPayload, callback_url: Optional[str] = None)

        return response.json().get("balance", 0.0)

    def create_task(self, task: TaskPayload, callback_url: Optional[str] = None) -> int:
        """
        Creates a task based on the provided payload and returns the task ID.

        This method is responsible for initiating a task by preparing the request with the
        provided task details and optional callback URL, sending a synchronous request to the
        task creation endpoint, and parsing the response to retrieve the task ID.

        Args:
            task: The task configuration payload that defines the specifics of the task to be
                created.
            callback_url: An optional URL to be called back upon task completion or update.

        Returns:
            The unique identifier of the created task.

        Raises:
            CapmonsterException: If the task creation request fails or the response is not contains valid task id.
        """
        payload = CreateTaskPayload(clientKey=self.api_key, task=task, callbackUrl=callback_url).model_dump(
            exclude_none=True)
        payload["softId"] = 30
        response = self.__make_sync_request(self.__CREATE_TASK_URL, payload).json()
        return response.get("taskId", 0)

    async def create_task_async(self, task: TaskPayload, callback_url: Optional[str] = None) -> int:
        """