ReCaptchaV3: решение reCaptcha v3
TIP
Создайте задачу с помощью метода createTask и получите результат с помощью метода getTaskResult.
Типы задач, которые мы поддерживаем:
ReCaptchaV3Task
- для этого типа задач требуются ваши собственные прокси.ReCaptchaV3EnterpriseTask
- для этого типа задач требуются ваши собственные прокси.ReCaptchaV3TaskProxyLess
- использует встроенный прокси сервера.ReCaptchaV3EnterpriseTaskProxyLess
- использует встроенный прокси сервера.
Создание задачи
Создайте задачу распознавания с помощью метода createTask.
Перед созданием задачи вы можете ознакомиться с следующей информацией:
Если вы получили недействительный ответ, вы можете изучить следующую информацию:
Структура объекта задачи
Свойства | Тип | Обязательно | Описание |
---|---|---|---|
type | String | Required | ReCaptchaV3Task ReCaptchaV3TaskProxyLess |
websiteURL | String | Required | Веб-адрес сайта, использующего hcaptcha, обычно это фиксированное значение. (Пример: https://google.com) |
websiteKey | String | Required | Публичный ключ домена, редко обновляемый. (Пример: b989d9e8-0d14-41sda0-870f-97b5283ba67d) |
pageAction | String | Required | Значение действия виджета. Владелец веб-сайта определяет, что пользователь делает на странице через этот параметр. Значение по умолчанию: verify Пример: grecaptcha.execute('site_key', {action:'login_test'}) . |
minScore | Double | Optional | Значение от 0,1 до 0,9. |
proxy | String | Optional | Узнать Использование прокси |
enterprisePayload | Object | Optional | Полезная нагрузка Enterprise |
apiDomain | String | Optional | Доменный адрес, с которого загружается reCAPTCHA Enterprise. Например: • http://www.google.com/ • http://www.recaptcha.net/ Не используйте этот параметр, если не знаете, зачем он нужен. |
userAgent | String | Optional | User-Agent браузера, используемый в эмуляции. Необходимо использовать подпись современного браузера, иначе Google попросит вас "обновить браузер". |
cookies | Array | Optional | Узнать Использование файлов cookie |
anchor | String | Optional | Как обойти все версии reCAPTCHA Enterprise v2, v2 невидимую, v3, v3 enterprise 0,9 балла |
reload | String | Optional | Как обойти все версии reCAPTCHA Enterprise v2, v2 невидимую, v3, v3 enterprise 0,9 балла |
Пример запроса
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/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"
}
}
После отправки задачи вы должны получить в ответе 'Идентификатор задачи' в случае успешного выполнения. Если вы не получили идентификатор задачи, прочтите Коды ошибок: полный список ошибок.
Пример ответа
{
"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": "ВАШ_КЛЮЧ_API",
"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": "ReCaptchaV3TaskProxyLess",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-", ...
})
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)
}