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:

Wie man die Callback-Funktion jeder Version von reCaptcha findet

Wenn Sie eine ungültige Antwort erhalten haben, können Sie Folgendes lernen:

Wie man alle Versionen von reCAPTCHA Enterprise v2, v2 unsichtbar, v3, v3 enterprise mit 0,9 Punkten umgeht

Struktur des Aufgabenobjekts

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 erscheint Hinweis: 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/

WARNING

Wenn Sie nicht wissen, wie Sie die Parameter übergeben sollten, lesen Sie bitte unseren Blog Verwenden Sie die Erweiterung capsolver, um automatische Parameter zu erhalten.

Wenn Sie feststellen, dass Sie eine niedrigere Token-Bewertung erhalten haben, senden Sie die von der Erweiterung erfassten JSON-Daten an den Kundenservice zur Optimierung.

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
        "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-", ...
})

reCAPTCHA v2 MTCaptcha