UNLOCK API
reCAPTCHA v2 Enterprise

reCAPTCHA v2 Enterprise

Jak wysłać zadanie reCAPTCHA v2 Enterprise do UNLOCK API przez createTask lub in.php: nazwy typów zadań, wszystkie parametry, obiekt solution, pola proxy i przykłady kodu w 7 językach.
Cena
$0.50 $0.0005 za zadanie
Wysyłasz
URL strony, klucz witryny i payload enterprise, jeśli strona go używa
Otrzymujesz
Token dla g-recaptcha-response

Przegląd i cena

Nazwy typu zadania

Użyj pierwszej nazwy, aby rozwiązywać bez proxy. Użyj drugiej nazwy i dodaj pola proxy, aby rozwiązywać przez własne proxy. Cena jest taka sama.
RecaptchaV2EnterpriseTaskProxylessBez proxy
RecaptchaV2EnterpriseTaskPrzez Twoje proxy

Obiekt zadania

type
StringWymagane
Nazwa typu zadania. Wielkość liter nie ma znaczenia. RecaptchaV2EnterpriseTaskProxyless | RecaptchaV2EnterpriseTask
websiteURL
StringWymagane
Pełny adres strony, na której pojawia się CAPTCHA, zaczynający się od http:// lub https://.
websiteKey
StringWymagane
Klucz witryny widżetu CAPTCHA, do znalezienia w źródle strony (na przykład data-sitekey).
enterprisePayload
ObjectOpcjonalne
Dodatkowe wartości, które strona przekazuje do grecaptcha.enterprise.render, na przykład s.
isInvisible
BooleanOpcjonalne
true dla niewidocznej wersji widżetu.
userAgent
StringOpcjonalne
User-Agent przeglądarki używany przy rozwiązywaniu. Wyślij ten sam, gdy przesyłasz odpowiedź.
cookies
StringOpcjonalne
Cookies dla strony jako pary name=value oddzielone średnikami.
apiDomain
StringOpcjonalne
Domena, z której ładuje się widżet: google.com lub recaptcha.net.

Pola niewymienione tutaj są przekazywane do rozwiązującego bez zmian.

Pola proxy

Tylko dla nazwy typu z proxy. Wyślij osobne pola albo jeden ciąg proxy.
proxyType
StringWymagane
http, https, socks4 lub socks5.
proxyAddress
StringWymagane
Adres IP lub nazwa hosta proxy.
proxyPort
IntegerWymagane
Port proxy.
proxyLogin
StringOpcjonalne
Nazwa użytkownika proxy, jeśli proxy jej wymaga.
proxyPassword
StringOpcjonalne
Hasło proxy, jeśli proxy go wymaga.
proxy
String
Wszystkie pola proxy w jednym ciągu, na przykład http://user:pass@1.2.3.4:8080.

Korzystanie z proxy

Żądanie

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2EnterpriseTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
  }
}

Obiekt solution

Zwracany w solution, gdy status ma wartość ready.
gRecaptchaResponse
String
Token. Wstaw go do pola g-recaptcha-response (lub h-captcha-response dla hCaptcha) albo przekaż do callbacku strony.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW..."
  },
  "cost": "0.0005",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Przykłady kodu

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "RecaptchaV2EnterpriseTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"]["gRecaptchaResponse"])
        break
else:
    raise SystemExit("timed out")

Metoda formularza in.php

To samo zadanie przez klasyczne żądanie formularza. res.php zwraca odpowiedź jako tekst.
in.php, res.php
curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=userrecaptcha&enterprise=1&googlekey=SITE_KEY&pageurl=https://example.com/login&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

API formularzy: in.php i res.php