Описание
Метод создает задачу на решение выбранного типа каптчи. В параметрах передаются авторизационные данные клиента, типизированные данные задачи и другие необязательные параметры.
Адрес метода: 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!"
}
}
Задача решения ReCaptcha2
{
"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. |
Пример ответа
Ответ в процессе выполнения
{
"errorCode": "null",
"errorDescription": "null",
"errorId": 0,
"status": "processing",
}
Ответ БЕЗ ошибки
{
"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
}