Настройка профиля сайта reCAPTCHA
Настройте сайт в разделе Профили сайтов и дождитесь, пока его профиль получит статус active, прежде чем запрашивать токен. Отправка имени хоста и действия в API задач не создаёт профиль.
На этой странице
Добавьте сайт в консоли
- 1.
Проверьте рабочее пространство
Настройте профиль для того рабочего пространства, API-ключ которого вы будете использовать для создания задач. Профиля в другом рабочем пространстве недостаточно. Если в консоли отображается предложение «Пополните баланс, чтобы продолжить», воспользуйтесь им, прежде чем продолжать настройку.
- 2.
Откройте «Добавить сайт»
В разделе «Профили сайтов» выберите «Добавить сайт». Введите адрес целевой HTTPS-страницы в поле «URL страницы». В поле «Тип reCAPTCHA» выберите Enterprise v3 или обычную v3 в соответствии со страницей.
- 3.
Задайте параметры захвата
Поле «Действие захвата» обязательно. Используйте действие, для которого планируете получать решение; если вы не уверены, сначала найдите действие reCAPTCHA. В форме также есть необязательные поля «URL навигации», «Ключ сайта» и «Значение Referer». Ключ сайта может быть определён автоматически.
- 4.
Отправьте форму
Нажмите «Добавить сайт». Проверенные системные профили могут заполнить известный контракт страницы и действие захвата без получения данных с сайта в реальном времени; форма поясняет выбранное действие. Другие отправленные заявки могут перейти в состояния очереди, захвата, валидации или проверки.
Проверьте статус полученного профиля. ACTIVE отображается как active; именно это состояние требуется для решения. Если захват завершится ошибкой, консоль покажет причину и позволит повторить попытку.
Запросите токен с использованием активного профиля
В этом теле задачи используются имя хоста и действие из профиля:
{
"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 на балансе рабочего пространства.