Перейти к основному содержимому
Возникают проблемы с получением токена?
Свяжитесь с поддержкой

RecaptchaV3TaskProxyless

Объект содержит данные о задаче на решение ReCaptcha3 от Google. Такая задача будет выполняться нашим сервисом с использованием наших собственных прокси-серверов.

ReCaptcha3, в отличие от ReCaptcha2, не требует от посетителя сайта каких-либо действий, она работает невидимо на фоне страницы, собирая и анализируя данные о пользователе, чтобы определить, является он человеком или ботом. На основе этой аналитики сайт получает рейтинг доверия (от 0.1 до 0.9).

При создании задачи необходимо дополнительно передавать два параметра - pageAction и minScore.

Параметры запроса

type<string>required

RecaptchaV3TaskProxyless


websiteURL<string>required

Адрес страницы, на которой решается капча


websiteKey<string>required

Ключ-идентификатор ReCaptcha3 на целевой странице.
https://www.google.com/recaptcha/api.js?render=THIS_ONE


minScore<double>optional

Может иметь значение от 0.1 до 0.9


pageAction<string>optional

Значение параметра action, которое передаётся виджетом ReCaptcha в Google, и которое потом видит владелец сайта при проверке токена. Значение по умолчанию: verify

Пример в html:
grecaptcha.execute('site_key', {action:'login_test'}).

Метод создания задачи

POST
https://api.capmonster.cloud/createTask

Запрос

{
"clientKey":"API_KEY",
"task": {
"type":"RecaptchaV3TaskProxyless",
"websiteURL":"https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey":"6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.3,
"pageAction": "myverify"
}
}

Ответ

{
"errorId":0,
"taskId":407533072
}

Метод получения результата задачи

Используйте метод getTaskResult, чтобы получить решение ReCaptcha3. В зависимости от загрузки системы вы получите ответ через время в диапазоне от 10 с до 30 с.

POST
https://api.capmonster.cloud/getTaskResult

Запрос

{
"clientKey":"API_KEY",
"taskId": 407533072
}

Ответ

{
"errorId":0,
"status":"ready",
"solution": {
"gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}

СвойствоТипОписание
gRecaptchaResponseStringХеш, который необходимо подставить в форму с ReCaptcha3 в <textarea id="g-recaptcha-response" ></textarea>. Имеет длину от 500 до 2190 байт.

Используйте библиотеку SDK

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, RecaptchaV3ProxylessRequest } from '@zennolab_com/capmonstercloud-client';

document.addEventListener('DOMContentLoaded', async () => {
const cmcClient = CapMonsterCloudClientFactory.Create(new ClientOptions({ clientKey: '<your capmonster.cloud API key>' }));
console.log(await cmcClient.getBalance());

const recaptchaV3Request = new RecaptchaV3ProxylessRequest({
websiteURL: 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high',
websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
minScore: 0.6,
pageAction: 'some-action',
});

console.log(await cmcClient.Solve(recaptchaV3Request));
});
Ещё больше по теме в нашем блоге