ReCaptchaV3: Lösung für reCAPTCHA v3
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.
Wenn Sie ein Token in einem Automatisierungswerkzeug wie playwright oder puppeteer verwenden möchten, bevor Sie eine Aufgabe erstellen, müssen Sie möglicherweise ihre Rückruffunktion für ihn finden, Referenz:
Struktur des Aufgabenobjekts
Wenn Sie nicht wissen, wie Sie Parameter festlegen, verwenden Sie bitte die CapSolver-Erweiterung, um automatisch die erforderlichen Parameter zu erhalten.
- Referenzartikel: Wie man Captcha erkennt und seine Parameter extrahiert
Wenn Sie feststellen, dass das v3-Token ungültig ist, verwenden Sie bitte die CapSolver-Erweiterung, um die JSON-Konfiguration zu erhalten und sie an unseren Kundenservice zur Konfiguration zu senden. Nach der Konfiguration wird es den Token-Score erheblich verbessern.
Eigenschaften | Typ | Erforderlich | Beschreibung |
---|---|---|---|
type | String | Required | ReCaptchaV3Task ReCaptchaV3TaskProxyLess ReCaptchaV3EnterpriseTask ReCaptchaV3EnterpriseTaskProxyLess |
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) |
proxy | String | Optional | Erfahren Sie mehr unter Verwendung von Proxys |
pageAction | String | Optional | Für v2-Standorte: Wenn in der anchor Anfrage ein sa-Parameter vorhanden ist, wird dieser Parameter übergeben Für v3-Sites: Suchen Sie nach grecaptcha.execute und finden Sie action Parameter |
enterprisePayload | Object | Optional | Die Enterprise-Version sucht nach grecaptcha.enterprise.render und liefert den s-Parameter. |
isSession | Bool | Optional | Session-Modus, aktiviert, gibt einen recaptcha-ca-t Wert zurück, der als Cookie verwendet wird und in der Regel in v3 erscheintHinweis: Einige Websites benötigen den Wert recaptcha-ca-e , der in der Regel in v2 erscheint, und wenn dieser Wert vorhanden ist, wird er automatisch zurückgegeben und keine zusätzlichen Parametereinstellungen erforderlich sind. |
apiDomain | String | Optional | Der Domainname des Verifikationscodes wird geladen, normalerweise muss dieser Parameter nicht übergeben werden • http://www.google.com/ • http://www.recaptcha.net/ |
Beispielanfrage
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV3Task",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
"enterprisePayload": {
"s": "SOME_ADDITIONAL_TOKEN" // Optional
},
"pageAction": "submit", // Optional
"apiDomain": "", // Optional
"proxy": "http:ip:port:user:pass", // socks5:ip:port:user:pass, Optional
}
}
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", // userAgent
"secChUa": "xxx", // Sec-Ch-Ua
"createTime": 1671615324290, // Token-Generierungszeit
"gRecaptchaResponse": "3AHJ......", // Antwort Token
"recaptcha-ca-t": "AbEM......", // Einige v3-Websites verfügen über einen Session-Modus, der als Cookie zurückgegeben wird, wenn isSession aktiviert ist.
"recaptcha-ca-e": "Abp_......" // Einige v2-Websites haben diesen Parameter, der als Cookie verwendet wird und automatisch zurückgegeben wird.
},
"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-", ...
})