reCAPTCHA v3

reCAPTCHA v3 无感验证，返回带评分的令牌。

v3 没有勾选框，是在后台静默打分的。pageAction 要和页面上调用 grecaptcha.execute(sitekey, {action}) 时传的 action 一致，否则令牌可能不被接受。

请求

POST /v1/captcha/solve?timeout=180
Authorization: Bearer arp_xxx
Content-Type: application/json

请求参数

只传上表列出的参数即可，认证由网关自动处理。

请求示例

{
  "type": "RecaptchaV3TaskProxyless",
  "websiteURL": "https://example.com/member/form",
  "websiteKey": "6LdJXmobAAAAAFLNEpWqZrAXDr4I3l2lFyMLdqoM",
  "pageAction": "homepage"
}

响应示例

{
  "ok": true, "ready": true, "price": 10, "balance": 970,
  "solution": { "gRecaptchaResponse": "03AGdBq27..." },
  "token": "03AGdBq27..."
}

完整调用

curl -X POST 'https://api.xiaobaicap.com/v1/captcha/solve?timeout=180' \
  -H "Authorization: Bearer arp_xxx" \
  -H 'Content-Type: application/json' \
  -d '{
         "type": "RecaptchaV3TaskProxyless",
         "websiteURL": "https://example.com/member/form",
         "websiteKey": "6LdJXmobAAAAAFLNEpWqZrAXDr4I3l2lFyMLdqoM",
         "pageAction": "homepage"
       }'

import requests

r = requests.post(
    "https://api.xiaobaicap.com/v1/captcha/solve",
    headers={"Authorization": "Bearer arp_xxx"},
    params={"timeout": 180},
    json={
  "type": "RecaptchaV3TaskProxyless",
  "websiteURL": "https://example.com/member/form",
  "websiteKey": "6LdJXmobAAAAAFLNEpWqZrAXDr4I3l2lFyMLdqoM",
  "pageAction": "homepage"
},
    timeout=200,
)
d = r.json()
if not d.get("ok"):
    raise SystemExit(d)
print(d.get("token") or d.get("text") or d.get("objects"))

注意事项

• action 对不上是 v3 失败最常见的原因，抓包确认一下。

错误

失败时返回 502，积分全额退回，可以安全重试：

{"error":"识别失败，已全额退回 10 积分：...","code":"mint_failed"}