Aufgabentyp
reCAPTCHA v3 Enterprise
RecaptchaV3EnterpriseTaskeigener Proxy
reCAPTCHA v3 hat kein Widget: Die Website bewertet jede Aktion mit einem Score von 0.0 bis 1.0. Die API liefert ein Token für die angeforderte pageAction; minScore legt den benötigten Score fest.
Enterprise-Variante: Die Website lädt enterprise.js und kann zusätzliche Daten in enterprisePayload übergeben – senden Sie diese unverändert mit.
Mit eigenem Proxy: Die Aufgabe wird über den übergebenen Proxy gelöst, sodass das Token zu Ihrer IP passt. Proxy-Zugangsdaten werden nach dem Lösen gelöscht.
Live-Metriken, 24 h
Live-Metriken für diesen Typ erscheinen nach dem Start auf der Statusseite.
Aufgabenparameter
| Parameter | Typ | erforderlich | Aufgabenparameter |
|---|---|---|---|
type | string | erforderlich | RecaptchaV3EnterpriseTask |
websiteURL | string | erforderlich | Vollständige URL der Seite mit dem Captcha. |
websiteKey | string | erforderlich | Site-Key (data-sitekey oder der Parameter k der anchor-Anfrage). |
minScore | number | optional | Benötigter Score von 0.1 bis 0.9. Höhere Scores dauern länger. |
pageAction | string | optional | Name der Aktion, den die Seite an grecaptcha.execute übergibt. |
enterprisePayload | object | optional | Zusätzliche Enterprise-Parameter, zum Beispiel s, als Objekt. |
apiDomain | string | optional | Domain, von der das Widget geladen wird: google.com oder recaptcha.net. |
userAgent | string | optional | User-Agent zum Lösen; verwenden Sie denselben beim Absenden des Tokens. |
cookies | string | optional | Cookies der Zielseite im Format key1=value1; key2=value2. |
proxyType | string | erforderlich | http, socks4 oder socks5. |
proxyAddress | string | erforderlich | IP-Adresse oder Host des Proxys (nur öffentliche Adressen). |
proxyPort | integer | erforderlich | Port des Proxys. |
proxyLogin | string | optional | Proxy-Login, falls der Proxy eine Authentifizierung erfordert. |
proxyPassword | string | optional | Proxy-Passwort. Wird nach dem Lösen der Aufgabe gelöscht. |
Beispiel
import time
import requests
API = "https://"
KEY = "YOUR_API_KEY"
# 1. create a task: the price is held, not charged
task = requests.post(f"{API}/createTask", json={
"clientKey": KEY,
"task": {
"type": "RecaptchaV3EnterpriseTask",
"websiteURL": "https://example.com/login",
"websiteKey": "6Le-SITE-KEY",
"minScore": 0.7,
"pageAction": "login",
"proxyType": "http",
"proxyAddress": "203.0.113.10",
"proxyPort": 8080,
"proxyLogin": "user",
"proxyPassword": "pass",
},
}).json()
if task["errorId"]:
raise RuntimeError(task["errorCode"])
# 2. poll the result (or pass "callbackUrl" and get a signed webhook)
while True:
time.sleep(3)
res = requests.post(f"{API}/getTaskResult",
json={"clientKey": KEY, "taskId": task["taskId"]}).json()
if res["errorId"]:
raise RuntimeError(res["errorCode"])
if res["status"] == "ready":
print(res["solution"]["gRecaptchaResponse"])
break