CAPTCHA de deslizar e de quebra-cabeça: como funcionam e como resolvê-los
No CAPTCHA de deslizar, você move um controle ao longo de uma barra. No CAPTCHA de quebra-cabeça, você encaixa uma peça no espaço correspondente de uma imagem. Alguns widgets combinam os dois formatos: o controle deslizante move a peça até o encaixe. Veja onde cada formato aparece, como ele se diferencia dos desafios de clique e quais dados a API do CapMonster Cloud espera quando você testa seus próprios formulários.
Principais pontos
- Para passar por uma verificação de deslizar, arraste o controle ou a peça do quebra-cabeça até a posição correta. A página então aceita ou rejeita a resposta.
- Os desafios de deslizar e de quebra-cabeça funcionam de forma parecida. Já nos desafios de clique, você seleciona caracteres, ícones ou partes de uma imagem.
- GeeTest, DataDome, FengkongCloud, ARCaptcha, NetEase Yidun e Tencent usam desafios de arrastar ou clicar em seus widgets.
- O CapMonster Cloud usa duas chamadas de API para resolver CAPTCHAs de deslizar: createTask recebe os parâmetros da página e getTaskResult retorna a solução.
- O FengkongCloud usa o tipo de tarefa CustomTask com a classe fengkongcloud. O ARCaptcha tem um tipo próprio, ArCaptchaTask.
O que é um CAPTCHA de deslizar?
É uma verificação em que você arrasta um controle ou uma peça de quebra-cabeça até a posição certa para continuar. O widget mostra uma barra com um controle deslizante, muitas vezes ao lado de uma imagem com uma peça faltando. Ao mover o controle, você desloca a peça pela imagem. Solte o controle quando a peça estiver alinhada com o recorte. A página deixa você seguir ou apresenta outro desafio.
A aparência varia conforme o provedor. Um exemplo simples é uma barra com uma seta que você arrasta até a ponta direita. Outros widgets mostram uma imagem com um recorte e deixam a peça correspondente à esquerda. Conforme você move o controle, a peça avança até preencher o espaço. Muitos exibem uma instrução curta, como “Drag to complete the puzzle”, e um ícone para carregar outra imagem.
Em um cadastro, login ou checkout, basta um movimento rápido para arrastar o controle. É mais simples do que digitar letras distorcidas ou clicar em todas as imagens com semáforos. O site consegue filtrar tráfego de bots e costuma mostrar o widget em etapas importantes, como a criação de uma conta ou a redefinição de senha.
Os dados da requisição à API variam conforme o provedor do widget. Descubra qual serviço o site usa antes de configurar o teste ou a automação. Se tiver dúvidas, consulte o guia sobre como identificar os tipos de CAPTCHA em um site.
CAPTCHA de deslizar, de quebra-cabeça e de clique
Cada formato pede um gesto diferente. O quebra-cabeça com controle deslizante combina os dois primeiros: quando você arrasta o controle, a peça se move até o espaço correspondente.
| Tipo | O que o usuário faz | Onde aparece | Como resolver pela API |
|---|---|---|---|
| Deslizar | Arrasta o controle ao longo da barra até o ponto indicado | GeeTest, DataDome, FengkongCloud, NetEase Yidun, Tencent | Envie o tipo de tarefa do provedor e os parâmetros da página em createTask. getTaskResult retorna a solução. No FengkongCloud, o token fica em solution.data.token |
| Quebra-cabeça (encaixe de peça) | Arrasta a peça até o recorte correspondente na imagem | GeeTest, DataDome, ARCaptcha, NetEase Yidun, Tencent | O fluxo usa as mesmas duas chamadas. No ARCaptcha, o tipo ArCaptchaTask retorna um token em solution.token |
| Clique ou seleção | Clica em ícones, caracteres ou partes da imagem na ordem indicada pelas instruções | GeeTest (seleção de ícones), FengkongCloud, NetEase Yidun, Tencent | Consulte as variantes na página da tarefa do provedor. A página do FengkongCloud traz apenas um exemplo de desafio de deslizar |
Na prática, é difícil traçar uma linha entre os dois primeiros formatos da tabela. No quebra-cabeça com controle deslizante, um só gesto move o controle e encaixa a peça. Em alguns sites, o widget alterna entre um desafio de deslizar, um quebra-cabeça e uma seleção por clique na mesma página. Um script feito para um único gesto pode parar de funcionar com essa mudança. Em tarefas que retornam um token, como as do FengkongCloud e do ARCaptcha, esse problema não ocorre. Os dados obrigatórios são a URL da página e a chave do site. A imagem do desafio não precisa ser enviada.
Exemplos de CAPTCHA de deslizar
Os quatro exemplos a seguir mostram widgets que você pode encontrar ao testar seus próprios formulários. O layout e as instruções variam, assim como o que acontece depois que você solta o controle.
O GeeTest v4 tem um widget compacto. No modo de deslizar, arraste o controle até a peça se encaixar no recorte da imagem de fundo. Entre os outros modos estão a seleção de ícones, Match-Three, Gobang e OneTap Pass. A página sobre como resolver o CAPTCHA do GeeTest v4 reúne os parâmetros e as instruções para configurar a tarefa.
O DataDome pode aparecer em uma tela intermediária que ocupa toda a página ou em um frame incorporado. O quebra-cabeça tem uma imagem de fundo, uma peça e um controle deslizante abaixo. A página sobre como resolver o CAPTCHA do DataDome explica como o CapMonster Cloud lida com esse desafio.
O widget do FengkongCloud pode apresentar um quebra-cabeça com controle deslizante, uma seleção de caracteres ou uma seleção de ícones. A documentação do CapMonster Cloud usa o desafio de deslizar como exemplo. Os scripts do widget são carregados de castatic.fengkongcloud.com, o que facilita identificar o provedor na aba Network.
O ARCaptcha tem três tipos de desafio: Hidden (invisível), Puzzle e Classic. No modo Hidden, o widget só aparece se pedir uma verificação adicional. No modo Puzzle, ele exibe um desafio que pede para arrastar a peça.
Como resolver um CAPTCHA de quebra-cabeça pela API
Para resolver um CAPTCHA de quebra-cabeça pela API, você faz duas chamadas: createTask e getTaskResult. O serviço que resolve CAPTCHAs de deslizar ou de quebra-cabeça recebe os parâmetros da página e devolve uma solução para o seu script usar. Ele não arrasta elementos no navegador.
createTask. Envie uma requisição POST em JSON para https://api.capmonster.cloud/createTask com sua clientKey e um objeto de tarefa. Em caso de sucesso, a resposta traz errorId igual a 0 e um taskId.
getTaskResult. Envie a clientKey e o taskId para https://api.capmonster.cloud/getTaskResult. Enquanto o status estiver como processing, espere pelo menos 2 segundos antes de fazer outra requisição. Quando o status mudar para ready, o resultado estará no objeto solution. A estrutura desse objeto depende do tipo de tarefa.
A documentação de cada provedor explica como resolver o CAPTCHA de quebra-cabeça com o tipo de tarefa correspondente. Os campos da requisição e os formatos de resposta variam. No ARCaptcha, por exemplo, o resultado é um token. No DataDome, são cookies.
Exemplo de requisição createTask para ARCaptcha
{
"clientKey": "API_KEY",
"task": {
"type": "ArCaptchaTask",
"websiteURL": "https://example.com/",
"websiteKey": "your-website-key",
"isInvisible": false,
"userAgent": "userAgentPlaceholder"
}
}Mantenha sua chave de API real no servidor ou em variáveis de ambiente. Não coloque a chave diretamente em scripts do lado do cliente nem a inclua em commits no repositório.
CAPTCHA do FengkongCloud
O FengkongCloud é um serviço de CAPTCHA que protege sites contra ações automatizadas. Ele pode mostrar um quebra-cabeça com controle deslizante, pedir que o visitante selecione caracteres conforme a instrução ou solicitar cliques em ícones de uma imagem. A documentação da tarefa no CapMonster Cloud traz um exemplo de desafio de deslizar.
Dois sinais ajudam a identificar o FengkongCloud no site e a obter os dados da tarefa: os scripts do widget vêm de castatic.fengkongcloud.com e a página faz uma requisição a /conf. Abra as ferramentas de desenvolvedor, recarregue a página e localize a requisição a /conf. Ela contém os identificadores usados para inicializar o widget. A documentação da tarefa do FengkongCloud indica qual deles vai em websiteKey.
| Campo da tarefa | Valor ou finalidade |
|---|---|
| type | CustomTask |
| class | fengkongcloud |
| websiteURL | Obrigatório. Endereço da página com o CAPTCHA |
| websiteKey | Obrigatório. Chave do widget obtida na página |
| metadata.apiJsUrl | Opcional. URL do script do widget |
| userAgent | Opcional. User-Agent do navegador |
Quando a tarefa do FengkongCloud fica pronta, o token vem em solution.data.token. Para consultar os detalhes da tarefa, veja a documentação sobre como resolver o CAPTCHA do FengkongCloud.
ARCaptcha
O ARCaptcha bloqueia atividades automatizadas com foco na privacidade e tem três modos. No modo Hidden, a verificação roda em segundo plano e só pede uma confirmação extra se houver suspeita de atividade de bot. No modo Puzzle, o usuário vê um desafio em que precisa arrastar uma peça. O Classic é o terceiro formato e segue o modelo tradicional de desafio.
Nos resultados de busca e em fóruns, você também pode encontrar o nome “AR captcha”. Se estiver verificando uma página que você mantém, consulte o código de inicialização do widget para confirmar o provedor. O widget em HTML pode usar o atributo data-site-key, e o componente React usa a prop site-key. Dependendo da integração, as configurações do widget também podem trazer site_key ou sitekey.
Para fazer o bypass do ARCaptcha ao testar seus próprios formulários, use os campos abaixo na tarefa.
| Campo da tarefa | Valor ou finalidade |
|---|---|
| type | ArCaptchaTask |
| websiteURL | Obrigatório. Endereço da página com o CAPTCHA |
| websiteKey | Obrigatório. Chave do site usada pelo widget |
| isInvisible | Opcional. Flag para o widget invisível |
| userAgent | Opcional. User-Agent do navegador |
A primeira resposta, da chamada a createTask, contém o taskId. Use esse identificador para consultar getTaskResult até a tarefa retornar ready. Em seguida, leia o token em solution.token. Esse fluxo também está descrito na documentação sobre como resolver o ARCaptcha.
Outros provedores chineses de CAPTCHA
O TCaptcha da Tencent oferece desafios de deslizar e de clique. O CapMonster Cloud aborda os dois formatos no guia sobre o CAPTCHA da Tencent. Também há materiais específicos sobre o Yidun (NetEase) e o CAPTCHA da Alibaba.
Erros e como lidar com eles
Se uma tarefa falhar, confira primeiro o código de erro da API.
- CAPTCHA_NOT_READY: a tarefa ainda está em andamento. Chame getTaskResult novamente pelo menos 2 segundos depois da requisição anterior.
- ERROR_TOO_MUCH_REQUESTS: o limite de requisições foi excedido. Aumente o intervalo entre as chamadas. Cada tarefa permite até 120 requisições a getTaskResult.
- ERROR_NO_SUCH_CAPCHA_ID: a tarefa não existe, o resultado já não está armazenado ou o identificador está no formato errado. Confira o ID da tarefa. Se o resultado tiver expirado, crie uma nova tarefa.
- ERROR_WRONG_USERAGENT: a requisição contém um User-Agent inválido. Substitua o userAgentPlaceholder dos exemplos pelo valor atual disponível no endpoint de User-Agent do CapMonster Cloud.
- ERROR_CAPTCHA_UNSOLVABLE: o serviço não conseguiu resolver o desafio. Antes de tentar novamente, confira se os parâmetros da tarefa estão corretos e atualizados.
- ERROR_TASK_NOT_SUPPORTED: confira o valor da propriedade type.
Perguntas frequentes
Conclusão
Seja um desafio de deslizar ou um quebra-cabeça, o primeiro passo para resolvê-lo pela API é identificar o provedor. No FengkongCloud, use CustomTask com a classe fengkongcloud. No ARCaptcha, use ArCaptchaTask e defina isInvisible como true somente no modo invisível.
Obtenha uma chave de API do CapMonster Cloud para começar os testes e consulte a documentação da API do CapMonster Cloud para conferir os parâmetros de cada tarefa.






