Menu da documentação

RecaptchaV3TaskProxyless: resolve Google Recaptcha v3

Esse tipo de objeto de tarefa é necessário para resolver Google Recaptcha V3 no computador de um worker. Essa tarefa será executada pelo nosso serviço usando nossos próprios servidores de proxy e/ou endereçoes de IP dos workers.

Note que não há diferença entre o Recaptcha V2-invisível e Recaptcha V3. Eles se parecem muito e isso pode confundir. Existe uma forma rápida de determinar o tipo correto: tente resolvê-lo com nossa API como V2-invisível e V3. Em uma das tentativas você receberá um erro, e no outro, não.

Nós testamos nossos workers pelo "score" (pontuação) de seus recaptchas e os colocamos em 3 grupos (filas): 0.3, 0.7 e 0.9. Cada um pode ter preço um pouco diferente devido à quatidade de workers ociosos. Ao passar a propriedade minScore, você define a fila na qual sua tarefa vai entrar. A maioria de nossos workers disponíveis possuem pontuação 0.3, e uma parcela menor possui 0.9.

Mais informações sobre Recaptcha V3 podem ser encontradas nesta seção FAQ.

Um exemplo de Recaptcha v3. Geralmente, existe um logotipo localizado no canto inferior direito da página. Mas ele pode ser facilmente removido com Javascript.

Objeto da tarefa

Propriedade Tipo Obrigatório Motivo
type String Sim RecaptchaV3TaskProxyless
websiteURL String Sim Endereço de uma página web de interesse. Pode estar localizado em qualquer lugar no website, até mesmo na área de membro. Nossos workers não navegam em tais lugares, mas simulam a visita.
websiteKey String Sim Chave de website do Recaptcha. Saiba como encontrá-la neste artigo.
minScore Double Sim Filtra um worker com uma determinada pontuação. O valor pode ser um dos seguintes:
0.3
0.7
0.9
pageAction String Não
O valor "action" (ação) do Recaptcha. O proprietário do website define o que o usuário está fazendo na página através desse parâmetro.
Exemplo:

grecaptcha.execute('site_key', {action:'login_test'})
isEnterprise Boolean Não Defina essa flag como "true" se você precisa deste V3 resolvido com a Enterprise API. O valor padrão é "false" e o Recaptcha é resolvido com a API não-enterprise. Pode ser determinado pela chamada javascript como no seguinte exemplo:

grecaptcha.enterprise.execute('site_key', {..})

Exemplo de solicitação

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"RecaptchaV3TaskProxyless",
            "websiteURL":"http://mywebsite.com/recaptcha/test.php",
            "websiteKey":"6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
            "minScore": 0.3,
            "pageAction": "myverify",
            "isEnterprise": false
        }
}' https://api.anti-captcha.com/createTask
        

Exemplo de resposta

JSON sem erros
          {
    "errorId": 0,
    "taskId": 7654321
}
        
JSON com um erro
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

Obter a solução

Use o método getTaskResult para solicitar a solução. Dê um tempo para o worker, como 5 segundos, antes de fazer a primeira solicitação. Se o worker ainda estiver ocupado, tente novamente em 3 segundos.

Objeto de solução de tarefa

Propriedade Tipo Motivo
gRecaptchaResponse String String de token que é necessária para interagir com o formulário de envio no website de interesse.

Exemplo de resposta

JSON sem erros
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}