Skip to content
On this page
Home
>Aufgabe (Token)
>ReCaptchaV2

ReCaptchaV2: Lösung für reCaptcha v2

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:

  • ReCaptchaV2Task für diesen Aufgabentyp sind eigene Proxys erforderlich.
  • ReCaptchaV2EnterpriseTask für diesen Aufgabentyp sind eigene Proxys erforderlich.
  • ReCaptchaV2TaskProxyLess verwendet den integrierten Proxy des Servers.
  • ReCaptchaV2EnterpriseTaskProxyLess 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

EigenschaftenTypErforderlichBeschreibung
TypStringRequiredReCaptchaV2Task
ReCaptchaV2TaskProxyLess
websiteURLStringRequiredWebadresse der Website, die hcaptcha verwendet, in der Regel handelt es sich um einen festen Wert. (Beispiel: https://google.com)
websiteKeyStringRequiredDer öffentliche Schlüssel der Domain, der selten aktualisiert wird. (Beispiel: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
proxyStringOptionalErfahren Sie mehr unter Verwendung von Proxys
pageActionStringOptionalEinige Websites in der Anchor-Endpunktn haben den Parameter sa, es handelt sich um den Action-Wert.
enterprisePayloadObjectOptionalEnterprise Payload
isInvisibleBoolOptionalWenn reCaptcha keine pageAction hat, hat die Reload-Anforderung den Flag "fi".
apiDomainStringOptionalDomä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.
userAgentStringOptionalDer 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".
cookiesArrayOptionalErfahren Sie mehr unter Verwendung von Cookies
anchorStringOptionalWie man alle Versionen von reCAPTCHA Enterprise v2, v2 unsichtbar, v3, v3 enterprise mit 0,9 Punkten umgeht
reloadStringOptionalWie man alle Versionen von reCAPTCHA Enterprise v2, v2 unsichtbar, v3, v3 enterprise mit 0,9 Punkten umgeht

Beispielanfrage

txt
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    // Erforderlich
    "type": "ReCaptchaV2Task",
    // Erforderlich
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    // Erforderlich
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      // Optional, erforderlich, wenn die Website reCaptcha Enterprise verwendet
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    "isInvisible": false,
    // Optional
    "pageAction": "submit",
    // 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 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": "ReCaptchaV2TaskProxyLess",
            "websiteURL": "https://www.google.com/recaptcha/api2/demo",
            "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
          })
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": "ReCaptchaV2TaskProxyLess",
		"websiteURL": "https://www.google.com/recaptcha/api2/demo",
		"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
	})
	if err != nil {
		log.Fatal(err)
		return
	}
	fmt.Println(solution)
}