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

ReCaptchaV2: resolvendo o reCaptcha v2

TIP

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

Os tipos de tarefa que suportamos são:

  • ReCaptchaV2Task este tipo de tarefa requer seus próprios proxies.
  • ReCaptchaV2EnterpriseTask este tipo de tarefa requer seus próprios proxies.
  • ReCaptchaV2TaskProxyLess está usando o proxy interno do servidor.
  • ReCaptchaV2EnterpriseTaskProxyLess 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
TypeStringRequiredReCaptchaV2Task
ReCaptchaV2TaskProxyLess
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)
proxyStringOptionalSaiba Como usar proxies
pageActionStringOptionalAlguns sites no endpoint de âncora têm o parâmetro "sa", é o valor da ação
enterprisePayloadObjectOptionalCarga corporativa
isInvisibleBoolOptionalse o reCaptcha não tiver ação de página, a bandeira de conteúdo de solicitação de recarga tem "fi"
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

txt
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    //Obrigatório
    "type": "ReCaptchaV2Task",
    //Obrigatório
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    //Obrigatório
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      //Opcional, requerido se o site usa o reCaptcha enterprise
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    "isInvisible": false,
    // Opcional
    "pageAction": "submit",
    //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"
}

Usar Solicitação SDK

python
#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'

import capsolver
# capsolver.api_key = "..."
solution = capsolver.solve({
            "type": "ReCaptchaV2TaskProxyLess",
            "websiteURL": "https://www.google.com/recaptcha/api2/demo",
            "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
          })
go
package main

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

func main() {
	// first you need to install sdk
	//go get github.com/capsolver/capsolver-go
	//export CAPSOLVER_API_KEY='...' or
	//capSolver := CapSolver{ApiKey:"..."}

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