Перейти к основному содержимому

createTask : создание задачи

Описание​

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

Адрес метода

<https://api.capmonster.cloud/createTask>​

формат запроса: JSON POST

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

clientKey​

Type: String
Обязательный: Да
Уникальный ключ вашей учетной записи, API ключ (найти можно тут)

task​

Type: Объект задачи
Обязательный: Да
Массив данных о задаче. Список типов задач капч здесь.

callbackUrl​

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

Примеры запросов​

Задача решения обычной капчи с изображением

    {
      "clientKey":"67b6bcbb1a728ea8d563de6d169a2057",
      "task": 
      {
        "type":"ImageToTextTask",
        "body":"BASE64_BODY_HERE!"
      }
    }

Задача решения ReCaptcha2

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

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

errorId​

Type: Integer
Обязательный: Да
Идентификатор ошибки.
0 - ошибок нет, задача успешно создана, идентификатор задачи находится в параметре taskId
1 - ошибка, информация о ней находится в свойстве errorCode

errorCode​

Type: String
Обязательный: Нет
Код ошибки. См. глоссарий ошибок.

taskId​

Type: 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
    }