Решение reCaptcha v2
Создайте задачу с помощью метода createTask и получите результат с помощью метода getTaskResult.
Типы задач types
, которые мы поддерживаем:
ReCaptchaV2Task
для этого типа задачи требуются ваши собственные прокси.ReCaptchaV2EnterpriseTask
для этого типа задачи требуются ваши собственные прокси.ReCaptchaV2TaskProxyLess
использует встроенный прокси сервер.ReCaptchaV2EnterpriseTaskProxyLess
использует встроенный прокси сервер.
Создание задачи
Создайте задачу распознавания с помощью метода createTask.
Прежде чем создать задачу, вы можете изучить следующее
Если вы получили недействительный ответ, вы можете узнать следующее
Структура объекта задачи
Свойства | Тип | Обязательно | Описание |
---|---|---|---|
Type | String | Required | ReCaptchaV2Task ReCaptchaV2TaskProxyLess |
websiteURL | String | Required | Веб-адрес сайта, использующего hcaptcha, обычно это фиксированное значение. (Например: https://google.com) |
websiteKey | String | Required | Публичный ключ домена, редко обновляемый. (Например: b989d9e8-0d14-41sda0-870f-97b5283ba67d) |
proxy | String | Optional | Узнайте Использование прокси |
pageAction | String | Optional | Некоторые сайты в конечной точке anchor имеют параметр sa, это значение действия |
enterprisePayload | Object | Optional | Дополнительные данные Enterprise |
isInvisible | Bool | Optional | Если reCaptcha не имеет pageAction, у флага reload request body content есть значение “fi” |
apiDomain | String | Optional | Домен, с которого загружается reCAPTCHA Enterprise. Например: • http://www.google.com/ • http://www.recaptcha.net/ Не используйте параметр, если не знаете, зачем он нужен. |
userAgent | String | Optional | User-Agent браузера, используемый при эмуляции. Необходимо использовать сигнатуру современного браузера, в противном случае Google попросит вас “обновить браузер”. |
cookies | Array | Optional | Узнайте Использование куки |
anchor | String | Optional | Как обойти все версии reCAPTCHA Enterprise v2, v2 invisible, v3, v3 enterprise с оценкой 0,9 |
reload | String | Optional | Как обойти все версии reCAPTCHA Enterprise v2, v2 invisible, v3, v3 enterprise с оценкой 0,9 |
Пример запроса
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
//Обязательно
"type": "ReCaptchaV2Task",
//Обязательно
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
//Обязательно
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
"enterprisePayload": {
//Опционально, требуется, если веб-сайт использует reCaptcha Enterprise
"s": "SOME_ADDITIONAL_TOKEN"
},
"isInvisible": false,
// Опционально
"pageAction": "submit",
//Опционально
"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"
}
}
После отправки задачи нам, вы должны получить в ответе “Идентификатор задачи”, если операция прошла успешно. Пожалуйста, ознакомьтесь с кодами ошибок: полный список ошибок, если вы не получили идентификатор задачи.
Пример ответа
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
Получение результатов
После получения идентификатора задачи вам нужно отправить идентификатор задачи для получения решения. Структура ответа объяснена в getTaskResult.
В зависимости от загрузки системы, результаты вы получите в интервале от 1 с
до 10 с
Пример запроса
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
Пример ответа
{
"errorId": 0,
"errorCode": null,
"errorDescription": null,
"solution": {
"userAgent": "xxx", //User-Agent
"expireTime": 1671615324290, //время истечения токена
"gRecaptchaResponse": "3AHJ....." //токен решения
},
"status": "ready"
}
Использование SDK
#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'
import capsolver
# capsolver.api_key = "..."
solution = capsolver.solve({
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
})