UNLOCK API
reCAPTCHA v2 Enterprise

reCAPTCHA v2 Enterprise

Cách gửi tác vụ reCAPTCHA v2 Enterprise tới UNLOCK API bằng createTask hoặc in.php: tên loại tác vụ, mọi tham số, object solution, trường proxy và code mẫu bằng 7 ngôn ngữ.
Giá
$0.50 $0.0005 mỗi tác vụ
Bạn gửi
URL trang, site key và payload enterprise nếu trang có dùng
Bạn nhận
Token cho g-recaptcha-response

Tổng quan và giá

Tên loại tác vụ

Dùng tên thứ nhất để giải không cần proxy. Dùng tên thứ hai và thêm các trường proxy để giải qua proxy của bạn. Giá như nhau.
RecaptchaV2EnterpriseTaskProxylessKhông dùng proxy
RecaptchaV2EnterpriseTaskQua proxy của bạn

Object task

type
StringBắt buộc
Tên loại tác vụ. Không phân biệt chữ hoa, chữ thường. RecaptchaV2EnterpriseTaskProxyless | RecaptchaV2EnterpriseTask
websiteURL
StringBắt buộc
Địa chỉ đầy đủ của trang có CAPTCHA, bắt đầu bằng http:// hoặc https://.
websiteKey
StringBắt buộc
Site key của widget CAPTCHA, tìm trong mã nguồn trang (ví dụ data-sitekey).
enterprisePayload
ObjectTùy chọn
Các giá trị thêm mà trang truyền vào grecaptcha.enterprise.render, ví dụ s.
isInvisible
BooleanTùy chọn
true với phiên bản ẩn của widget.
userAgent
StringTùy chọn
User-Agent trình duyệt dùng khi giải. Gửi đúng User-Agent đó khi bạn gửi kết quả.
cookies
StringTùy chọn
Cookie của trang, dạng các cặp name=value cách nhau bằng dấu chấm phẩy.
apiDomain
StringTùy chọn
Tên miền mà widget tải từ đó: google.com hoặc recaptcha.net.

Các trường không có trong danh sách này được chuyển nguyên cho người giải.

Trường proxy

Chỉ dùng cho tên loại có proxy. Gửi các trường riêng lẻ hoặc một chuỗi proxy.
proxyType
StringBắt buộc
http, https, socks4 hoặc socks5.
proxyAddress
StringBắt buộc
Địa chỉ IP hoặc tên host của proxy.
proxyPort
IntegerBắt buộc
Cổng proxy.
proxyLogin
StringTùy chọn
Tên đăng nhập proxy, nếu proxy cần.
proxyPassword
StringTùy chọn
Mật khẩu proxy, nếu proxy cần.
proxy
String
Tất cả trường proxy trong một chuỗi, ví dụ http://user:pass@1.2.3.4:8080.

Dùng proxy

Request

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

Object solution

Trả về trong solution khi status là ready.
gRecaptchaResponse
String
Token. Đặt vào trường g-recaptcha-response (hoặc h-captcha-response với hCaptcha), hoặc truyền vào callback của trang.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW..."
  },
  "cost": "0.0005",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Code mẫu

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")

Phương thức form in.php

Cùng tác vụ đó với request form kiểu cũ. res.php trả kết quả dạng văn bản.
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 form: in.php và res.php