Como resolver o Cloudflare Turnstile?

TL;DR

• O Cloudflare Turnstile é uma alternativa moderna de CAPTCHA projetada para bloquear tráfego automatizado com mínima interação do usuário.
• O CapSolver suporta todos os variantes do Turnstile (Manual, Não Interativo e Invisível) com detecção automática.
• A tarefa AntiTurnstileTaskProxyLess permite resolver o Turnstile sem fornecer seu próprio proxy.
• O token retornado pelo getTaskResult deve ser submetido ao site de destino para completar a verificação com sucesso.

Introdução

O Cloudflare Turnstile é uma alternativa de CAPTCHA focada na privacidade que substitui os desafios tradicionais de reCAPTCHA. Foi projetado para reduzir a fricção do usuário, ao mesmo tempo em que previne efetivamente o abuso automatizado. Do ponto de vista do desenvolvedor, no entanto, o Turnstile apresenta novos desafios para automação, testes e fluxos de coleta de dados.

Ao contrário do desafio de 5 segundos do Cloudflare, o Turnstile depende da validação baseada em token em vez de continuidade do fingerprint do navegador. Isso o torna mais fácil de integrar, desde que os parâmetros e o tipo de tarefa corretos sejam usados.

Neste guia, você aprenderá:

• Os diferentes tipos de Turnstile tratados pelo CapSolver
• Como o CapSolver gerencia automaticamente os desafios do Turnstile
• Como usar a AntiTurnstileTaskProxyLess para resolver o Turnstile sem um proxy
• Como recuperar e submeter o token corretamente para evitar rejeições

Este tutorial é adequado para desenvolvedores que buscam uma solução rápida, escalável e de baixa manutenção para o Turnstile.

Tipos de Turnstiles Tratados pelo CapSolver

O CapSolver lida automaticamente com todos os variantes do Cloudflare Turnstile, incluindo:

• Manual
• Não Interativo
• Invisível

Nenhuma configuração adicional é necessária para distinguir entre esses tipos — o CapSolver detecta e processa automaticamente.

Superando o Cloudflare Turnstile

Antes de resolver o Cloudflare Turnstile, certifique-se de atender aos seguintes pré-requisitos e compreender os requisitos de validação.

Pré-requisitos

• Chave da API do CapSolver

Considerações Essenciais para uma Solução Válida

• O token retornado na resposta do getTaskResult é o último token de verificação do CAPTCHA.
• Este token deve ser submetido ao site de destino exatamente como esperado pelo fluxo de verificação do Turnstile.

Para uma explicação completa dos parâmetros, consulte a documentação oficial:
https://docs.capsolver.com/en/guide/captcha/cloudflare_turnstile/

Neste tutorial, focamos apenas nos parâmetros necessários. O tipo de tarefa suportado para o Cloudflare Turnstile é:

• AntiTurnstileTaskProxyLess – usa a infraestrutura de proxy interna do CapSolver

Este tipo de tarefa é recomendado quando o site está protegido pelo Cloudflare Turnstile e não requer reutilização do fingerprint do navegador.

Etapa 1: Iniciando uma Tarefa com o CapSolver

Crie uma tarefa usando a API createTask e envie as informações necessárias:

POST https://api.capsolver.com/createTask

{
  "clientKey": "SUA_CHAVE_DA_API",
  "task": {
    "type": "AntiTurnstileTaskProxyLess",
    "websiteURL": "https://www.seusite.com",
    "websiteKey": "0x4XXXXXXXXXXXXXXXXX",
    "metadata": {
      "action": "login",  
      "cdata": "0000-1111-2222-3333-exemplo-cdata"
    }
  }
}

• websiteKey é obrigatório
• metadata.action e metadata.cdata são opcionais e dependem da implementação do site

Etapa 2: Recuperando os Resultados

Verifique o endpoint getTaskResult até que a tarefa seja concluída:

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "SUA_CHAVE_DA_API",
  "taskId": "ID_DA_TAREFA_DA_CREATE_TASK"
}

Assim que resolvido, a resposta incluirá um token válido do Turnstile:

Usando o Token do Turnstile Corretamente

Para completar a verificação no site de destino:

• Submeta o token retornado ao endpoint de verificação do Turnstile do site
• Certifique-se de usar o token antes de expirar
• Não reutilize tokens em sessões não relacionadas

⚠️ Se o token for rejeitado, verifique se o site está protegido pelo Cloudflare Turnstile e não pelo desafio de 5 segundos do Cloudflare, que requer um tipo de tarefa e parâmetros diferentes.

Conclusão

O Cloudflare Turnstile oferece uma alternativa simplificada aos CAPTCHAs tradicionais, mas a automação ainda exige um processo confiável de geração de tokens.

O CapSolver simplifica a resolução do Turnstile por meio da AntiTurnstileTaskProxyLess, eliminando a necessidade de proxies personalizados ou gerenciamento de fingerprint do navegador. Ao fornecer os parâmetros corretos e submeter corretamente o token retornado, os desenvolvedores podem integrar a resolução do Turnstile em seus fluxos de trabalho rapidamente e em escala.

Com a configuração adequada, resolver o Cloudflare Turnstile se torna eficiente, previsível e pronto para produção.

Perguntas Frequentes

1. Qual é a diferença entre o Cloudflare Turnstile e o desafio de 5 segundos?

O Turnstile é um mecanismo de CAPTCHA baseado em token, enquanto o desafio de 5 segundos é um processo de verificação de fingerprint do navegador e rede. Eles exigem tipos de tarefa diferentes.

2. Eu preciso de meu próprio proxy para resolver o Cloudflare Turnstile?

Não. A AntiTurnstileTaskProxyLess usa a infraestrutura de proxy interna do CapSolver.

3. Por que meu token do Turnstile foi rejeitado?

Motivos comuns incluem websiteKey incorreto, tokens expirados ou tentativa de resolver um desafio de 5 segundos do Cloudflare em vez do Turnstile.

4. O mesmo token pode ser reutilizado várias vezes?

Não. Os tokens do Turnstile são únicos e vinculados a uma sessão ou ação específica.

Para soluções do desafio de 5 segundos do Cloudflare (IUAM), consulte:
https://www.capsolver.com/blog/how-to-solve-cloudflare-challenge