# RecaptchaV3Task

The object contains data for Google ReCaptcha3 solving task. This task will be executed by our service using our own proxy servers.

ReCaptcha3, unlike ReCaptcha2, does not require any action from the site visitor, it works invisibly in the background of the page, collecting and analyzing data about the user to determine whether he is a human or a bot. Based on this analytics, the site receives a trust rating (from 0.1 to 0.9).

When creating a task, you should additionally pass two parameters - pageAction and minScore.

# Object structure

Parameter	Type	Required	Value
type	String	yes	RecaptchaV3TaskProxyless or RecaptchaV3Task
websiteURL	String	yes	Address of a webpage with Google ReCaptcha.
websiteKey	String	yes	Recaptcha website key. https://www.google.com/recaptcha/api.js?render=THIS_ONE
minScore	Double	no	Value from 0.1 to 0.9.
pageAction	String	no	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'})`

# Request body example

API ADDRESS

POST https://api.byecap.ru/newTask

{
  "clientKey":"dce6bcbb1a728ea8d871de6d169a2057",
  "task": {
    "type":"RecaptchaV3TaskProxyless",
    "websiteURL":"https://lessons.byecap.ru/captchas/recaptcha/v3.php?level=beta",
    "websiteKey":"6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
    "minScore": 0.3,
    "pageAction": "myverify"
  }
}

# Response example

{
  "errorId":0,
  "taskId":407533072
}

# Getting result

Use the result method to request answer for ReCaptcha3. You will get response within 10 - 30 secs period depending on service workload.

gRecaptchaResponse Hash which should be inserted into Recaptcha2 submit form in <textarea id="g-recaptcha-response" ..></textarea> . It has a length of 500 to 2190 bytes.

# Response example

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
  }
}