ReCaptchaV3: Lösung für reCAPTCHA v3
TIP
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:
ReCaptchaV3Task
für diesen Aufgabentyp sind eigene Proxys erforderlich.ReCaptchaV3EnterpriseTask
für diesen Aufgabentyp sind eigene Proxys erforderlich.ReCaptchaV3TaskProxyLess
verwendet den integrierten Proxy des Servers.ReCaptchaV3EnterpriseTaskProxyLess
verwendet 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 | ReCaptchaV3Task ReCaptchaV3TaskProxyLess |
websiteURL | String | Required | Webadresse der Website, die 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
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"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
{
"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
{
"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
# 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-", ...
})