Guia
Tarefa (Token)
reCAPTCHA v3

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, se você precisar usar tokens em ferramentas de automação como playwright e puppeteer, talvez precise encontrar a função de chamada de volta para elas. Referência:

Estrutura do Objeto da Tarefa

WARNING

Se você não sabe como definir os parâmetros, use a extensão CapSolver para obter os parâmetros necessários automaticamente.


Se você achar que o token v3 não é válido, use a extensão CapSolver para obter a configuração JSON e enviá-la ao nosso serviço ao cliente para a configuração. Após a configuração, a pontuação do token será significativamente melhorada.

PropriedadesTipoObrigatórioDescrição
typeStringRequiredReCaptchaV3Task
ReCaptchaV3TaskProxyLess
ReCaptchaV3EnterpriseTask
ReCaptchaV3EnterpriseTaskProxyLess
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
pageActionStringOptionalPara sites v2: se houver um parâmetro sa na solicitação de ancoragem, passe o parâmetro
Para sites v3: procure grecaptcha.execute para encontrar o parâmetro action
enterprisePayloadObjectOptionalPesquisa da versão enterprise grecaptcha.enterprise.render, passando o parâmetro s
isInvisibleBoolOptionalSem a caixa de seleção “Eu não sou um robô”, mas em caso de desafios, passe true, geralmente necessário no modo invisível v2
isSessionBoolOptionalModo de sessão, quando habilitado, retorna um valor recaptcha-ca-t usado como cookie, normalmente no v3

Nota: Alguns sites exigem o valor recaptcha-ca-e que geralmente aparece na v2 e, caso exista, é devolvido automaticamente e não requer configurações de parâmetros adicionais.
apiDomainStringOptionalCarregar o nome de domínio do código de verificação, geralmente não é necessário passar este parâmetro
• http://www.google.com/
• http://www.recaptcha.net/

Exemplo de Solicitação

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-",
    "enterprisePayload": {
      "s": "SOME_ADDITIONAL_TOKEN" // Optional
    },
    "pageAction": "submit", // Optional
    "apiDomain": "", // Optional
    "proxy": "http:ip:port:user:pass", // socks5:ip:port:user:pass, Optional
  }
}

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
        "secChUa": "xxx", // Sec-Ch-Ua
        "createTime": 1671615324290, // Tempo de geração do token
        "gRecaptchaResponse": "3AHJ......", // Token
        "recaptcha-ca-t": "AbEM......", // Alguns sites v3 têm um modo de sessão, e este parâmetro é retornado quando a isSession é ativada para ser usada como cookie.
        "recaptcha-ca-e": "Abp_......" // Alguns sites v2 têm esse parâmetro e são usados como um cookie que retorna automaticamente se existir.
    },
    "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 v2MTCaptcha