Почему solvethree использует профиль сайта вместо поля websiteKey
solvethree хранит ключ сайта reCAPTCHA и настройки страницы в профиле сайта. Запрос задачи передает имя хоста в site, действие выполнения в action и прокси, а не websiteKey или websiteURL.
Если вы переходите с другого API, это не просто переименование полей. Сначала настройте активный профиль в рабочем пространстве: передача имени хоста, действия или ключа сайта не создает его.
На этой странице
Настройте ключ сайта и страницу в консоли
- 1.
Откройте «Добавить сайт»
Откройте Профили сайтов и выберите «Добавить сайт». Введите HTTPS URL страницы целевого сайта. Задача будет использовать имя хоста, а не этот полный URL. При необходимости укажите необязательные URL перехода и значение Referer для настройки страницы.
- 2.
Выберите тип и проверьте ключ сайта
Выберите Enterprise v3 для интеграции reCAPTCHA Enterprise или Regular v3 для обычной reCAPTCHA v3. Форма может автоматически определить ключ сайта; чтобы переопределить его, укажите значение в необязательном поле «Ключ сайта».
- 3.
Задайте действие захвата
Действие захвата обязательно. Для запроса ниже настройте профиль с действием захвата
login. Проверенные системные профили могут подставить известные настройки страницы и действие захвата без загрузки актуальных данных; прочитайте пояснение к выбранному действию в форме. - 4.
Отправьте и дождитесь активации
Выберите «Добавить сайт». До активации заявка может пройти состояния очереди, захвата, валидации или проверки; время захвата не гарантируется. В некоторых аккаунтах отображается «Пополните баланс, чтобы продолжить». Если захват не удался, изучите причину перед повторной попыткой.
Используйте отдельный профиль для каждого сочетания имени хоста, действия захвата и типа reCAPTCHA. Точное совпадение действия выполнения выбирает соответствующий профиль. Для других действий выполнения нужна одна однозначно определяемая цель захвата, поэтому не считайте, что один профиль имени хоста охватывает все действия.
Отправьте плоский запрос задачи
Когда профиль станет активным, отправьте этот объект напрямую как JSON-тело запроса POST /v1/tasks. Для аутентификации используйте Authorization: Bearer, указав далее API-ключ рабочего пространства, и храните этот ключ на сервере.
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}site— это имя хоста: без схемы, пути и строки запроса. Полный URL страницы указывается в профиле в консоли.action— действие выполнения для этой задачи. Здесьloginсовпадает с действием захвата, настроенным выше.proxyзадает прокси для решения. Требуется ровно одно из полей:proxyилиproxyCandidates; не отправляйте оба.requestIdнеобязателен. Если время ожидания создания истекло, повторная отправка того же запроса с тем же ID вернет существующую задачу. Изменение входных данных задачи при повторном использовании этого ID приводит к конфликту.
Не переносите websiteKey, websiteURL, type или url из структуры запроса предыдущего API. Для reCAPTCHA значение recaptchaType по умолчанию — enterprise-v3, поэтому в примере оно опущено. Для обычной v3 задайте recaptchaType равным v3.
Источники и справочник API
Запустите первую задачу.
Начните с $5 на балансе рабочего пространства.