Логотип «2Captcha»Перейти на главную страницу
API решения капчиПрокси API

Yandex SmartCaptcha

Yandex SmartCaptcha

Мы предлагаем два метода решения Yandex SmartCaptcha в API v2: на основе токена и через координаты на изображении.

Для работы с этим методом используйте эндпоинт https://api.2captcha.com/createTask и получайте результат через https://api.2captcha.com/getTaskResult.

Спецификация методов

  • YandexSmartCaptchaTaskProxyless — решение с использованием наших прокси
  • YandexSmartCaptchaTask — решение с использованием ваших прокси
  • CoordinatesTask — решение капчи по изображению с возвратом координат

Решение с помощью токена

YandexSmartCaptchaTaskProxyless / YandexSmartCaptchaTask

Свойство Тип Обязателен Описание
type String Да Тип задачи: YandexSmartCaptchaTaskProxyless или YandexSmartCaptchaTask
websiteURL String Да Полный URL страницы, где загружена капча
websiteKey String Да Значение sitekey из кода страницы или iframe капчи
userAgent String Нет Ваш userAgent, который будет использован при решении
cookies String Нет Куки для передачи в запросе, формат: name1=value1;name2=value2

Прокси-параметры (только для YandexSmartCaptchaTask)

Свойство Тип Обязателен Описание
proxyType String Да Тип прокси: http, https, socks4, socks5
proxyAddress String Да IP-адрес или хост прокси-сервера
proxyPort Number Да Порт прокси-сервера
proxyLogin String Нет Логин для авторизации на прокси
proxyPassword String Нет Пароль для авторизации на прокси

Пример запроса

Метод: createTask
Эндпоинт: https://api.2captcha.com/createTask

json Copy 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "YandexSmartCaptchaTaskProxyless",
    "websiteURL": "https://mysite.com/",
    "websiteKey": "Y5Lh0ti..."
  }
}

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

Метод: getTaskResult
Эндпоинт: https://api.2captcha.com/getTaskResult

json Copy 
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "dV9xNjYyNTU3NjkxO4k9OTQuNVMuMjkuMjM9O9Q9MVEzQUEwMURERTY3RkUxQ9U3MTlEQzE3RjhYNTJCQUFFN9YyQTc3QUNFQjk9NzhVOTZGNjVCOEUyOVM4RTg9Q9VEQzY9NzY4O3U9MTY4MjU3NTY5MTQ4MTI3MVUyNVTo2ImVWMmQ4NWQzNjdlNzM9MVYhOGI5NWMxNWZlM4E4"
  }
}

Используйте полученный токен в поле smart-token или передайте его в бекенд сайта аналогично ручному решению капчи.

Решение с помощью изображения (CoordinatesTask)

Возвращает координаты кликов или порядок объектов, а не токен. Подходит для визуальных заданий Яндекс СмартКапчи.

Спецификация задачи

Свойство Тип Обязателен Описание
type String Да Тип задачи: CoordinatesTask
body String Да Основное изображение капчи в формате Base64
imgType String Да Тип капчи: smart_captcha или pazl_smart_captcha
imgInstructions String Нет* Изображение инструкции в Base64.
* Обязательно для imgType=smart_captcha
comment String Нет* Текстовая подсказка для исполнителя.
* Рекомендуется для imgType=smart_captcha, например: select objects in the order of the instruction

Вариант 1: Выбор объектов по инструкции (smart_captcha)

json Copy 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CoordinatesTask",
    "body": "BASE64_IMAGE",
    "imgType": "smart_captcha",
    "imgInstructions": "BASE64_INSTRUCTION_IMAGE",
    "comment": "select objects in the order of the instruction"
  }
}

Вариант 2: Капча-пазл (pazl_smart_captcha)

json Copy 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CoordinatesTask",
    "body": "BASE64_IMAGE",
    "imgType": "pazl_smart_captcha"
  }
}

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

json Copy 
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "coordinates": [
      {"x": 57, "y": 82},
      {"x": 239, "y": 75},
      {"x": 138, "y": 113},
      {"x": 154, "y": 42},
      {"x": 230, "y": 155}
    ]
  }
}

Для smart_captcha обязательно передавайте imgInstructions — без него исполнитель может неверно понять задачу. Параметр comment помогает уточнить порядок действий, особенно если инструкция на изображении неочевидна.