CapSolverReCaptchaV3: Lösung für reCaptcha v3
::: Tipp Erstellen Sie die Aufgabe mit der Methode createTask und erhalten Sie das Ergebnis mit der Methode getTaskResult. :::
Die von uns unterstützten Aufgabentypen types sind:
ReCaptchaV3Taskfür diesen Aufgabentyp sind eigene Proxys erforderlich.ReCaptchaV3EnterpriseTaskfür diesen Aufgabentyp sind eigene Proxys erforderlich.ReCaptchaV3TaskProxyLessverwendet den integrierten Proxy des Servers.ReCaptchaV3EnterpriseTaskProxyLessverwendet den integrierten Proxy des Servers.
Aufgabe erstellen
Erstellen Sie eine Erkennungsaufgabe mit der Methode createTask.
Bevor Sie eine Aufgabe erstellen, können Sie Folgendes lernen:
Wenn Sie eine ungültige Antwort erhalten haben, können Sie Folgendes lernen:
Struktur des Aufgabenobjekts
| Eigenschaften | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| type | String | Required | ReCaptchaV3TaskReCaptchaV3TaskProxyLess |
| websiteURL | String | Required | Webadresse der Website, die hcaptcha verwendet, in der Regel handelt es sich um einen festen Wert. (Beispiel: https://google.com) |
| websiteKey | String | Required | Der öffentliche Schlüssel der Domain, der selten aktualisiert wird. (Beispiel: b989d9e8-0d14-41sda0-870f-97b5283ba67d) |
| pageAction | String | Required | Widget-Action-Wert. Der Website-Inhaber definiert, was der Benutzer auf der Seite tut, durch diesen Parameter. Standardwert: verify Beispiel: grecaptcha.execute('site_key', {action:'login_test'}). |
| minScore | Double | Optional | Wert von 0,1 bis 0,9. |
| proxy | String | Optional | Erfahren Sie mehr unter Verwendung von Proxys |
| enterprisePayload | Object | Optional | Enterprise Payload |
| apiDomain | String | Optional | Domänenadresse, von der reCAPTCHA Enterprise geladen werden soll. Zum Beispiel: • http://www.google.com/ • http://www.recaptcha.net/ Verwenden Sie keinen Parameter, wenn Sie nicht wissen, wofür er benötigt wird. |
| userAgent | String | Optional | Der User-Agent des Browsers, der bei der Emulation verwendet wird. Es ist erforderlich, dass Sie eine Signatur eines modernen Browsers verwenden, da Google Sie sonst auffordert, "Ihren Browser zu aktualisieren". |
| cookies | Array | Optional | Erfahren Sie mehr unter Verwendung von Cookies |
| anchor | String | Optional | Wie man alle Versionen von reCAPTCHA Enterprise v2, v2 unsichtbar, v3, v3 enterprise mit 0,9 Punkten umgeht |
| reload | String | Optional | Wie man alle Versionen von reCAPTCHA Enterprise v2, v2 unsichtbar, v3, v3 enterprise mit 0,9 Punkten umgeht |
Beispielanfrage
json
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/jsonjson
{
"clientKey": "YOUR_API_KEY",
"task": {
// Erforderlich
"type": "ReCaptchaV3Task",
// Erforderlich
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
// Erforderlich
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
// Erforderlich
"pageAction": "login",
// Optional
"minScore": 0.7,
"enterprisePayload": {
// Optional, erforderlich, wenn die Website reCaptcha Enterprise verwendet
"s": "SOME_ADDITIONAL_TOKEN"
},
// Optional
"apiDomain": "",
// Optional
"userAgent": "",
// Optional
"cookies": [
{
"name": "__Secure-3PSID",
"value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
},
{
"name": "__Secure-3PAPISID",
"value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
}
],
// Optional
"proxy": "http:ip:port:user:pass",
// socks5:ip:port:user:pass
// Optional, Sie müssen diesen Parameter nur einmal senden und das Ergebnis erfolgreich erhalten, Sie können diesen Parameter entfernen
"anchor": "base64 content",
"reload": "base64 content"
}
}Nachdem Sie die Aufgabe an uns übermittelt haben, sollten Sie in der Antwort eine 'Aufgaben-ID' erhalten, wenn dies erfolgreich ist. Bitte lesen Sie errorCode: vollständige Liste von Fehlern, wenn Sie die Aufgaben-ID nicht erhalten haben.
Beispielantwort
json
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
``
`
## Ergebnisse abrufen
Nachdem Sie die Aufgaben-ID haben, müssen Sie die Aufgaben-ID senden, um die Lösung abzurufen. Die Struktur der Antwort wird in [getTaskResult](../api-gettaskresult.md) erläutert.
Je nach Systemauslastung erhalten Sie die Ergebnisse im Intervall von `1s` bis `10s`.
### Beispielanfrage
``` json
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}Beispielantwort
json
{
"errorId": 0,
"errorCode": null,
"errorDescription": null,
"solution": {
"userAgent": "xxx", //User-Agent
"expireTime": 1671615324290, //Ablaufzeit des Tokens
"gRecaptchaResponse": "3AHJ....." //Lösungstoken
},
"status": "ready"
}Verwendung von SDK-Anfragen
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() {
// Installieren Sie zuerst das 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)
}