ReCaptchaV2Enterprise/ReCaptchaV3Enterprise协议

captchaRun

553字约2分钟

2024-05-21

注意：该API目前处于测试阶段，如果需要帮助联系客服。

创建任务

参数名	是否必填	说明
captchaType	是	`ReCaptchaV2Enterprise` / `ReCaptchaV3Enterprise`
siteKey	是	ReCaptcha SiteKey
siteReferer	是	ReCaptcha Referer
siteAction	否	ReCaptcha Action (V3 必填), 某些站点会有action参数，在anchor请求中如果有sa参数，就代表你需要添加这个参数。例子：`grecaptcha.execute('site_key', {action:'login_test'})`
payload	否	一些网站的实现可能会包含其他参数，见下方详细说明
domain	否	加载reCAPTCHA Enteprise的domain。例子：`http://www.google.com/` `http://www.recaptcha.net/`
anchor	否	设置该参数企业版v2，v3,获得0.9的分值
reload	否	设置该参数企业版v2，v3,获得0.9的分值

请求样例

POST https://api.captcha.run/v2/tasks

Content-Type: application/json
Authorization: Bearer 00000000-0000-0000-0000-000000000000

{
    "captchaType":"ReCaptchaV2Enterprise",
    "siteReferer":"https://login.wdahjghkhdj.net/",
    "siteKey":"6Lc_aCMTCCCCCBx7u2N0D1XnVbI_v6ZdbM6rYf16",
    "payload": {
        "s": "ADDITIONAL_INFO"
    } 
 }

CURL代码

curl -X POST "https://api.captcha.run/v2/tasks" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer 00000000-0000-0000-0000-000000000000" \
     -d '{
        "captchaType":"ReCaptchaV2Enterprise",
        "siteReferer":"https://login.wdahjghkhdj.net/",
        "siteKey":"6Lc_aCMTCCCCCBx7u2N0D1XnVbI_v6ZdbM6rYf16",
        "payload": {
            "s": "ADDITIONAL_INFO"
        } 
    }'

Python代码

import requests

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer 00000000-0000-0000-0000-000000000000',
}

json_data = {
    'captchaType': 'ReCaptchaV2Enterprise',
    'siteReferer': 'https://login.wdahjghkhdj.net/',
    'siteKey': '6Lc_aCMTCCCCCBx7u2N0D1XnVbI_v6ZdbM6rYf16',
    'payload': {
        's': 'ADDITIONAL_INFO',
    },
}

response = requests.post('https://api.captcha.run/v2/tasks', headers=headers, json=json_data)

返回样例

{
    "taskId": "dee46ee7-f261-455f-8866-f7b60c3af65f" // 请记录此 ID
}

获取识别结果

参考 🔗获取任务结果: /v2/tasks/{taskId}

获取参数

获取 SiteKey / SiteReferer

siteKey 和 siteReferer 如红框所示.

大部分情况, siteReferer 就是网站的域名

siteReferer 不是包含 recaptcha.net / Google 的链接

获取 payload

如果网页中出现了除了sitekey/theme等常规参数的其他参数，例如：

grecaptcha.enterprise.render("id", {
 sitekey: "6Lc_aCMTCCCCCBx7u2N0D1XnVbI_v6ZdbM6rYf16",
 theme: "dark",
 s: "2Jv...ugQA"
});

其中s就可以作为payload对象的一个属性传入API中

说明

Recaptcha V2 Enterprise 速度通常为80s以内