Настройка профиля сайта reCAPTCHA

Автор: solvethree3 мин на чтение

Настройте сайт в разделе Профили сайтов и дождитесь, пока его профиль получит статус active, прежде чем запрашивать токен. Отправка имени хоста и действия в API задач не создаёт профиль.

На этой странице

Добавьте сайт в консоли

  1. 1.

    Проверьте рабочее пространство

    Настройте профиль для того рабочего пространства, API-ключ которого вы будете использовать для создания задач. Профиля в другом рабочем пространстве недостаточно. Если в консоли отображается предложение «Пополните баланс, чтобы продолжить», воспользуйтесь им, прежде чем продолжать настройку.

  2. 2.

    Откройте «Добавить сайт»

    В разделе «Профили сайтов» выберите «Добавить сайт». Введите адрес целевой HTTPS-страницы в поле «URL страницы». В поле «Тип reCAPTCHA» выберите Enterprise v3 или обычную v3 в соответствии со страницей.

  3. 3.

    Задайте параметры захвата

    Поле «Действие захвата» обязательно. Используйте действие, для которого планируете получать решение; если вы не уверены, сначала найдите действие reCAPTCHA. В форме также есть необязательные поля «URL навигации», «Ключ сайта» и «Значение Referer». Ключ сайта может быть определён автоматически.

  4. 4.

    Отправьте форму

    Нажмите «Добавить сайт». Проверенные системные профили могут заполнить известный контракт страницы и действие захвата без получения данных с сайта в реальном времени; форма поясняет выбранное действие. Другие отправленные заявки могут перейти в состояния очереди, захвата, валидации или проверки.

Проверьте статус полученного профиля. ACTIVE отображается как active; именно это состояние требуется для решения. Если захват завершится ошибкой, консоль покажет причину и позволит повторить попытку.

Запросите токен с использованием активного профиля

В этом теле задачи используются имя хоста и действие из профиля:

reCAPTCHA Enterprise · структура запроса
{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}
  • site — имя хоста из поля «URL страницы», без схемы и пути.
  • action — действие для защищённого запроса. Оно должно соответствовать профилю, который вы собираетесь использовать.
  • Значение recaptchaType по умолчанию — enterprise-v3. Для профиля обычной v3 явно укажите v3.
  • Замените заглушку прокси на HTTP(S)-прокси, который вы также будете использовать для целевого запроса.

В руководствах по быстрому старту на Python и быстрому старту на Node.js показано, как отправить запрос и использовать результат.

Устраните проблему с отсутствующим или неактивным профилем

Для задачи нет доступного профиля.

Сопоставьте рабочее пространство, связанное с вашим API-ключом, и имя хоста задачи с настроенным профилем.

Попробуйте: Добавьте нужный профиль сайта в рабочем пространстве, которое будет создавать задачу. Повторное создание задачи не создаст отсутствующий профиль.

Профиль находится в очереди, в процессе захвата, валидации или проверки.

Посмотрите его текущее состояние в разделе «Профили сайтов».

Попробуйте: Дождитесь, пока профиль станет активным, прежде чем запрашивать решение. Эти состояния не заменяют активный профиль.

Захват завершился ошибкой.

Прочитайте причину ошибки, указанную в консоли.

Попробуйте: Устраните указанную причину ошибки, затем повторите захват.

Профиль активен, но для нужного действия он по-прежнему не определяется.

Сравните имя хоста, действие захвата и тип reCAPTCHA. Если действие выполнения отличается, проверьте, есть ли одна однозначно определённая цель захвата.

Попробуйте: Настройте профиль для нужного имени хоста, действия и типа вместо того, чтобы менять действие задачи на постороннее лишь ради выбора существующего профиля.

Источники и справочник API

Запустите первую задачу.

Начните с $5 на балансе рабочего пространства.

Создать рабочее пространство
Настройка профиля сайта reCAPTCHA · solvethree