ReCaptchaV3: resolvendo o reCAPTCHA v3

TIP

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

Como encontrar a função de retorno de chamada de cada versão do reCaptcha

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

Como contornar todas as versões do reCAPTCHA Enterprise v2, v2 invisível, v3, v3 enterprise com pontuação de 0,9

Estrutura do Objeto da Tarefa

Propriedades	Tipo	Obrigatório	Descrição
type	String	Required	`ReCaptchaV3Task` `ReCaptchaV3TaskProxyLess`
websiteURL	String	Required	Endereço web do site que utiliza o reCaptcha, geralmente é um valor fixo. (Ex: https://google.com)
websiteKey	String	Required	A chave pública do domínio, raramente atualizada. (Ex: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
pageAction	String	Required	Valor 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'})`.
minScore	Double	Optional	Valor de 0,1 a 0,9.
proxy	String	Optional	Saiba Como usar proxies
enterprisePayload	Object	Optional	Carga corporativa
apiDomain	String	Optional	Domí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.
userAgent	String	Optional	User-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”.
cookies	Array	Optional	Saiba Como usar Cookies
anchor	String	Optional	Como contornar todas as versões do reCAPTCHA Enterprise v2, v2 invisível, v3, v3 enterprise com pontuação de 0,9
reload	String	Optional	Como 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

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/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

{
    "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

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

{
    "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

# 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