Skip to content
On this page
Home
>Задача(Token)
>ReCaptchaV3

ReCaptchaV3: решение reCaptcha v3

TIP

Создайте задачу с помощью метода createTask и получите результат с помощью метода getTaskResult.

Типы задач, которые мы поддерживаем:

  • ReCaptchaV3Task - для этого типа задач требуются ваши собственные прокси.
  • ReCaptchaV3EnterpriseTask - для этого типа задач требуются ваши собственные прокси.
  • ReCaptchaV3TaskProxyLess - использует встроенный прокси сервера.
  • ReCaptchaV3EnterpriseTaskProxyLess - использует встроенный прокси сервера.

Создание задачи

Создайте задачу распознавания с помощью метода createTask.

Перед созданием задачи вы можете ознакомиться с следующей информацией:

Если вы получили недействительный ответ, вы можете изучить следующую информацию:

Структура объекта задачи

СвойстваТипОбязательноОписание
typeStringRequiredReCaptchaV3Task
ReCaptchaV3TaskProxyLess
websiteURLStringRequiredВеб-адрес сайта, использующего hcaptcha, обычно это фиксированное значение. (Пример: https://google.com)
websiteKeyStringRequiredПубличный ключ домена, редко обновляемый. (Пример: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
pageActionStringRequiredЗначение действия виджета. Владелец веб-сайта определяет, что пользователь делает на странице через этот параметр. Значение по умолчанию: verify Пример: grecaptcha.execute('site_key', {action:'login_test'}).
minScoreDoubleOptionalЗначение от 0,1 до 0,9.
proxyStringOptionalУзнать Использование прокси
enterprisePayloadObjectOptionalПолезная нагрузка Enterprise
apiDomainStringOptionalДоменный адрес, с которого загружается reCAPTCHA Enterprise.
Например:
http://www.google.com/
http://www.recaptcha.net/
Не используйте этот параметр, если не знаете, зачем он нужен.
userAgentStringOptionalUser-Agent браузера, используемый в эмуляции. Необходимо использовать подпись современного браузера, иначе Google попросит вас "обновить браузер".
cookiesArrayOptionalУзнать Использование файлов cookie
anchorStringOptionalКак обойти все версии reCAPTCHA Enterprise v2, v2 невидимую, v3, v3 enterprise 0,9 балла
reloadStringOptionalКак обойти все версии reCAPTCHA Enterprise v2, v2 невидимую, v3, v3 enterprise 0,9 балла

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

json
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
json
{
  "clientKey": "ВАШ_КЛЮЧ_API",
  "task": {
    //Обязательно
    "type": "ReCaptchaV3Task",
    //Обязательно
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    //Обязательно
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    //Обязательно
    "pageAction": "login",
    //Опционально
    "minScore": 0.7,
    "enterprisePayload": {
      //Опционально, требуется, если веб-сайт использует reCAPTCHA Enterprise
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    //Опционально
    "apiDomain": "",
    //Опционально
    "userAgent": "",
    //Опционально
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"


      }
    ],
    //Опционально                
    "proxy": "http:ip:port:user:pass",
    // socks5:ip:port:user:pass
    //Опционально, Вы можете удалить этот параметр после успешной отправки задачи и получения результата
    "anchor": "base64 content",
    "reload": "base64 content"
  }
}

После отправки задачи вы должны получить в ответе 'Идентификатор задачи' в случае успешного выполнения. Если вы не получили идентификатор задачи, прочтите Коды ошибок: полный список ошибок.

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

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" 
}

Получение результатов

После получения идентификатора задачи вам необходимо отправить идентификатор задачи, чтобы получить решение. Структура ответа объяснена в getTaskResult.

В зависимости от загрузки системы вы получите результаты в интервале от 1 с до 10 с

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

json
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json

{
    "clientKey": "ВАШ_КЛЮЧ_API",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

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

json
{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", //User-Agent
        "expireTime": 1671615324290, //Срок действия токена
        "gRecaptchaResponse": "3AHJ....." //Токен решения
    },
    "status": "ready"
}

Использование SDK-запроса

python
# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'

import capsolver

# capsolver.api_key = "..."
solution = capsolver.solve({
    "type": "ReCaptchaV3TaskProxyLess",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-", ...
})
go
package main

import (
	"fmt"
	capsolver_go "github.com/capsolver/capsolver-go"
	"log"
)

func main() {
	// Сначала вам нужно установить SDK
	//go get github.com/capsolver/capsolver-go
	//export CAPSOLVER_API_KEY='...' or
	//capSolver := CapSolver{ApiKey:"..."}

	capSolver := capsolver_go.CapSolver{}
	solution, err := capSolver.Solve(map[string]any{
		"type":       "ReCaptchaV3TaskProxyLess",
		"websiteURL": "https://www.google.com/recaptcha/api2/demo",
		"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-",
	})
	if err != nil {
		log.Fatal(err)
		return
	}
	fmt.Println(solution)
}