UNLOCK API
reCAPTCHA v3

reCAPTCHA v3

Cara menghantar tugas reCAPTCHA v3 ke UNLOCK API dengan createTask atau in.php: nama jenis tugas, setiap parameter, objek solution, medan proxy dan contoh kod dalam 7 bahasa.
Harga
$0.55 $0.00055 setiap tugas
Anda hantar
URL halaman, site key, page action dan skor minimum
Anda terima
Token untuk g-recaptcha-response

Ringkasan dan harga

Nama jenis tugas

Gunakan nama pertama untuk menyelesaikan tanpa proxy. Gunakan nama kedua dan tambah medan proxy untuk menyelesaikan melalui proxy anda sendiri. Harganya sama.
RecaptchaV3TaskProxylessTanpa proxy
RecaptchaV3TaskMelalui proxy anda

Turut diterima: RecaptchaV3Enterprise, RecaptchaV3EnterpriseTaskProxyless, RecaptchaV3EnterpriseTask

Objek task

type
StringWajib
Nama jenis tugas. Dipadankan tanpa mengira huruf besar atau kecil. RecaptchaV3TaskProxyless | RecaptchaV3Task
websiteURL
StringWajib
Alamat penuh halaman tempat CAPTCHA dipaparkan, bermula dengan http:// atau https://.
websiteKey
StringWajib
Site key widget CAPTCHA, terdapat dalam sumber halaman (contohnya data-sitekey).
pageAction
StringPilihan
Nama action yang dihantar oleh halaman dengan execute, contohnya login.
minScore
NumberPilihan
Skor yang anda perlukan, dari 0.1 hingga 0.9.
isEnterprise
BooleanPilihan
true untuk reCAPTCHA v3 Enterprise.
apiDomain
StringPilihan
Domain tempat widget dimuatkan: google.com atau recaptcha.net.

Medan yang tidak disenaraikan di sini dihantar kepada penyelesai seperti yang dihantar.

Medan proxy

Hanya untuk nama jenis proxy. Hantar sama ada medan berasingan atau satu rentetan proxy.
proxyType
StringWajib
http, https, socks4 atau socks5.
proxyAddress
StringWajib
Alamat IP atau nama host proxy.
proxyPort
IntegerWajib
Port proxy.
proxyLogin
StringPilihan
Nama pengguna proxy, jika proxy memerlukannya.
proxyPassword
StringPilihan
Kata laluan proxy, jika proxy memerlukannya.
proxy
String
Semua medan proxy dalam satu rentetan, contohnya http://user:pass@1.2.3.4:8080.

Menggunakan proxy

Permintaan

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

Objek solution

Dipulangkan dalam solution apabila status ialah ready.
gRecaptchaResponse
String
Token. Masukkan ke dalam medan g-recaptcha-response (atau h-captcha-response untuk hCaptcha), atau hantar kepada callback halaman.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq27hXmT6Rq9k..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Contoh kod

import time, requests

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

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "RecaptchaV3TaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
      "pageAction": "login",
      "minScore": 0.7
    }
}).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")

Kaedah borang in.php

Tugas yang sama dengan permintaan borang klasik. res.php memulangkan jawapan sebagai teks.
in.php, res.php
curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=userrecaptcha&version=v3&action=login&min_score=0.7&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 borang: in.php dan res.php