Guia
Tarefa (Token)
reCAPTCHA v2

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
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/
WARNING

Se você não sabe como passar os parâmetros, consulte nosso blog Use a extensão capsolver para obter parâmetros automaticamente.

Se você achar que tem uma pontuação de token baixa, envie os dados do json obtidos pela extensão ao serviço de atendimento ao cliente para otimização.

Exemplo de Solicitação

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV2Task",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      "s": "SOME_ADDITIONAL_TOKEN" // Optional
    },
    "isInvisible": false, // 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
        "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"
}

Usar Solicitação SDK

#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-",
          })
GeetestreCAPTCHA v3