Описание

Метод создает задачу на решение выбранного типа каптчи. В параметрах передаются авторизационные данные клиента, типизированные данные задачи и другие необязательные параметры.

Адрес метода: https://api.capmonster.cloud/createTask
Формат запроса: JSON POST

Параметры запроса

Параметр

Тип

Обязательный

Значение

clientKey

String

Да

Уникальный ключ вашей учетной записи, API ключ (найти можно тут)

task

Объект задачи

Да

Массив данных о задаче. Список типов задач капч здесь.

callbackUrl

String

Нет

Веб адрес для отправки результата задачи капчи. Данные отправляются POST запросом.
Содержимое идентично ответу метода getTaskResult.
Содержимое ответа не проверяется и сервер должен успеть принять запрос за 2 секунды, затем соединение закрывается.

Примеры

{
    "clientKey":"67b6bcbb1a728ea8d563de6d169a2057",
    "task":
        {
            "type":"ImageToTextTask",
            "body":"BASE64_BODY_HERE!"
        }
}
{
    "clientKey":"67b6bcbb1a728ea8d563de6d169a2057",
    "task":
        {
            "type":"NoCaptchaTaskProxyless",
            "websiteURL":"https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
            "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
        }
}

Структура ответа

Параметр

Тип

Значение

errorId

Integer

Идентификатор ошибки.
0 - ошибок нет, задача успешно создана, идентификатор задачи находится в параметре taskId
1 - ошибка, информация о ней находится в свойстве errorCode

errorCode

String

Код ошибки. См. глоссарий ошибок.

taskId

Integer

Идентификатор задания для последующего использования в методе getTaskResult.

Пример ответа

{
    "errorId": 0,
    "taskId": 7654321
}
{
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system or has incorrect format",
    "taskId": 0
}