Skip to content
On this page
Home
>Tarefa (Token)
>ReCaptchaV3

ReCaptchaV3: resolvendo o reCaptcha v3

::: dica Crie a tarefa com o método createTask e obtenha o resultado com o método getTaskResult. :::

Os tipos de tarefa types que oferecemos suporte são:

  • ReCaptchaV3Task este tipo de tarefa requer seus próprios proxies.
  • ReCaptchaV3EnterpriseTask este tipo de tarefa requer seus próprios proxies.
  • ReCaptchaV3TaskProxyLess está usando o proxy interno do servidor.
  • ReCaptchaV3EnterpriseTaskProxyLess está usando o proxy interno do servidor.

Criar Tarefa

Crie uma tarefa de reconhecimento com o método createTask.

Antes de criar uma tarefa, você pode aprender o seguinte

Se você receber uma resposta inválida, pode aprender o seguinte

Estrutura do Objeto da Tarefa

PropriedadesTipoObrigatórioDescrição
typeStringRequiredReCaptchaV3Task
ReCaptchaV3TaskProxyLess
websiteURLStringRequiredEndereço web do site que utiliza o reCaptcha, geralmente é um valor fixo. (Ex: https://google.com)
websiteKeyStringRequiredA chave pública do domínio, raramente atualizada. (Ex: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
pageActionStringRequiredValor da ação do widget. O proprietário do site define o que o usuário está fazendo na página por meio deste parâmetro. Valor padrão: verify. Exemplo: grecaptcha.execute('site_key', {action:'login_test'}).
minScoreDoubleOptionalValor de 0,1 a 0,9.
proxyStringOptionalSaiba Como usar proxies
enterprisePayloadObjectOptionalCarga corporativa
apiDomainStringOptionalDomínio de onde carregar o reCAPTCHA Enterprise.
Por exemplo:
http://www.google.com/
http://www.recaptcha.net/
Não use um parâmetro se você não souber por que ele é necessário.
userAgentStringOptionalUser-Agent do navegador usado na emulação. É necessário que você use uma assinatura de um navegador moderno, caso contrário o Google pedirá para "atualizar seu navegador".
cookiesArrayOptionalSaiba Como usar Cookies
anchorStringOptionalComo contornar todas as versões do reCAPTCHA Enterprise v2, v2 invisível, v3, v3 enterprise com pontuação de 0,9
reloadStringOptionalComo contornar todas as versões do reCAPTCHA Enterprise v2, v2 invisível, v3, v3 enterprise com pontuação de 0,9

Exemplo de Solicitação

json
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    //Obrigatório
    "type": "ReCaptchaV3Task",
    //Obrigatório
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    //Obrigatório
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    //Obrigatório
    "pageAction": "login",
    //Opcional
    "minScore": 0.7,
    "enterprisePayload": {
      //Opcional, requerido se o site usa o reCaptcha enterprise
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    //Opcional
    "apiDomain": "",
    //Opcional
    "userAgent": "",
    //Opcional
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
      }
    ],
    //Opcional                
    "proxy": "http:ip:port:user:pass",
    // socks5:ip:port:user:pass
    //Opcional, Você só precisa enviar uma vez e obter o resultado com sucesso, você pode remover esse parâmetro
    "anchor": "conteúdo base64",
    "reload": "conteúdo base64"
  }
}

Após enviar a tarefa para nós, você deverá receber na resposta um 'ID de tarefa' se for bem-sucedido. Por favor, leia errorCode: lista completa de erros se você não receber o ID da tarefa.

Exemplo de Resposta

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" 
}

Obtendo Resultados

Depois de obter o taskId, você precisa enviar o

taskId para recuperar a solução. A estrutura de resposta é explicada em getTaskResult.

Dependendo da carga do sistema, você receberá os resultados dentro do intervalo de 1s a 10s

Exemplo de Solicitação

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

{
    "clientKey": "YOUR_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Exemplo de Resposta

json
{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", //User-Agent
        "expireTime": 1671615324290, //Expiração do token
        "gRecaptchaResponse": "3AHJ....." //Token de solução
    },
    "status": "ready"
}

Usando Solicitação de SDK

python
# 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-", ...
})
go
package main

import (
	"fmt"
	capsolver_go "github.com/capsolver/capsolver-go"
	"log"
)

func main() {
	// primeiro você precisa instalar o sdk
	//go get github.com/capsolver/capsolver-go
	//export CAPSOLVER_API_KEY='...' ou
	//capSolver := CapSolver{ApiKey:"..."}

	capSolver := capsolver_go.CapSolver{}
	solution, err := capSolver.Solve(map[string]any{
		"type":       "ReCaptchaV3TaskProxyLess",
		"websiteURL": "https://www.google.com/recaptcha/api2/demo",
		"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-",
	})
	if err != nil {
		log.Fatal(err)
		return
	}
	fmt.Println(solution)
}