ReCaptchaV3 协议接口

TIP

通过 createTask 创建任务，然后通过 getTaskResult 获取识别结果

任务类型type如下

ReCaptchaV3Task 必须传入代理
ReCaptchaV3EnterpriseTask 必须传入代理
ReCaptchaV3TaskProxyLess 无需代理或已内置代理
ReCaptchaV3EnterpriseTaskProxyLess 无需代理或已内置代理

创建任务

通过 createTask 创建任务

在创建任务前，你可以学习下面的内容

如何查找 reCaptcha 各个版本的回调函数

如果获得了无效的token,你可以学习下面的内容

如何通过recaptcha 企业版v2，v3,获得0.9的分值

参数结构

属性	类型	Required	说明
type	String	Yes	`ReCaptchaV3Task` `ReCaptchaV3TaskProxyLess` `ReCaptchaV3EnterpriseTask` `ReCaptchaV3EnterpriseTaskProxyLess`
websiteURL	String	Yes	reCaptcha 网页地址，一般固定值。
websiteKey	String	Yes	reCaptcha 网站密钥，固定值。
pageAction	String	Yes	Widget action value. Website owner defines what user is doing on the page through this parameter. Default value: verify Example: `grecaptcha.execute('site_key', {action:'login_test'})`.
minScore	Double	No	Value from 0.1 to 0.9.
proxy	String	No	学习如何使用代理
enterprisePayload	Object	No	enterprise payload
apiDomain	String	No	Domain address from which to load reCAPTCHA Enterprise. For example: • http://www.google.com/ • http://www.recaptcha.net/ Don’t use a parameter if you don’t know why it’s needed.
userAgent	String	No	Browser’s User-Agent which is used in emulation. It is required that you use a signature of a modern browser, otherwise Google will ask you to “update your browser”.
cookies	Array	No	学习如何使用cookies
anchor	String	No	学习如何通过recaptcha 企业版v2，v3,获得0.9的分值
reload	String	No	学习如何通过recaptcha 企业版v2，v3,获得0.9的分值

请求示例

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV3Task",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "pageAction": "login",
    "minScore": 0.7,
    //This parameter is optional        
    "enterprisePayload": {
      //This parameter is optional
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    //This parameter is optional
    "apiDomain": "",
    //This parameter is optional
    "userAgent": "",
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
      }
    ],
    //This parameter is optional
    "proxy": "http:ip:port:user:pass",
    // socks5:ip:port:user:pass
    "anchor": "base64 content",
    "reload": "base64 content",
  }
}

响应示例

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID
}

获取结果

使用 getTaskResult 方法获取识别结果

根据系统负载，您将在 1s 到 20s 的时间间隔内得到结果

请求示例

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

响应示例

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", //userAgent
        "expireTime": 1671615324290, //过期时间
        "gRecaptchaResponse": "3AHJ....." //响应token
    },
    "status": "ready"
}

使用 SDK 请求

# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'
 
import capsolver
 
# capsolver.api_key = "..."
solution = capsolver.solve({
    "type": "ReCaptchaV3TaskProxyLess",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-", ...
})

reCAPTCHA v2 MTCaptcha