reCAPTCHA v3 识别 API

概览

每 1,000 次价格

$0.55 (每个任务 $0.00055)

createTask 类型

RecaptchaV3TaskProxyless, RecaptchaV3Task

in.php 方法

userrecaptcha, version=v3

你发送

页面网址、site key、页面 action 和最低分数

你得到

用于 g-recaptcha-response 的令牌

在哪里找到这些值

site key 在 api.js 地址的 render= 参数中，或在 grecaptcha.execute 调用中。pageAction 是传给 execute 的 action 名称。

createTask 和 getTaskResult

创建任务，等待约 5 秒，然后每 5 秒查询一次结果，直到状态为 ready。如果任务失败，API 会返回错误，费用退回余额。

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

while True:
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(r["errorCode"])   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"]["gRecaptchaResponse"])
        break

in.php 和 res.php

使用经典表单 API 发送同样的任务。加上 json=1 可获得 JSON 回复；不加则回复纯文本，例如 OK|1001。

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