
Nikolai Smirnov
Software Development Lead

token retornado pelo getTaskResult deve ser submetido ao site de destino para completar a verificação com sucesso.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á:
Este tutorial é adequado para desenvolvedores que buscam uma solução rápida, escalável e de baixa manutenção para o Turnstile.
O CapSolver lida automaticamente com todos os variantes do Cloudflare Turnstile, incluindo:

Nenhuma configuração adicional é necessária para distinguir entre esses tipos — o CapSolver detecta e processa automaticamente.
Antes de resolver o Cloudflare Turnstile, certifique-se de atender aos seguintes pré-requisitos e compreender os requisitos de validação.
token retornado na resposta do getTaskResult é o último token de verificação do CAPTCHA.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 é:
Este tipo de tarefa é recomendado quando o site está protegido pelo Cloudflare Turnstile e não requer reutilização do fingerprint do navegador.
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óriometadata.action e metadata.cdata são opcionais e dependem da implementação do siteVerifique 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:

Para completar a verificação no site de destino:
token retornado ao endpoint de verificação do Turnstile do site⚠️ 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.
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.
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.
Não. A AntiTurnstileTaskProxyLess usa a infraestrutura de proxy interna do CapSolver.
Motivos comuns incluem websiteKey incorreto, tokens expirados ou tentativa de resolver um desafio de 5 segundos do Cloudflare em vez do Turnstile.
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
Entenda as principais diferenças entre Cloudflare Challenge vs Turnstile e aprenda a identificá-los para automação web bem-sucedida. Obtenha dicas de especialistas e um solucionador recomendado.

Aprenda a corrigir o Erro 1005 do Cloudflare acesso negado durante o web scraping. Descubra soluções como proxies residenciais, fingerprinting de navegador e CapSolver para CAPTCHA. Otimize sua extração de dados.
