Resolva reCAPTCHA v3 padrão com a API

O v3 padrão também exige um perfil de site ativo disponível no seu espaço de trabalho. Configure o site de destino no console antes de criar uma tarefa; enviar um hostname e uma ação não cria o perfil.

• site: o hostname de destino, como accounts.example.com, não a URL completa de uma página.
• action: a ação usada pela integração de reCAPTCHA do destino. Substitua o login do exemplo se o destino usar outra ação. Veja como encontrar a ação.
• proxy ou proxyCandidates: forneça exatamente um deles. O exemplo usa um único proxy. Se você usar candidatos, a lista aceita no máximo doze URLs distintas de proxy HTTP ou HTTPS, sem caminho, consulta ou fragmento.

Envie este corpo JSON para POST https://api.solvethree.com/v1/tasks. Autentique-se com uma chave de API do espaço de trabalho no cabeçalho Authorization, usando o esquema Bearer. Mantenha a chave no seu servidor.

{
  "site": "accounts.example.com",
  "action": "login",
  "recaptchaType": "v3",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "v3-login-001"
}

recaptchaType fica no nível superior, ao lado de site, action e proxy. Não adicione um campo type ou url para reCAPTCHA.

Substitua o hostname, a ação e o proxy do exemplo pelos valores do destino. Use um novo requestId para cada nova resolução lógica. Se a criação atingir o timeout, reenvie o mesmo corpo da tarefa com o mesmo ID para recuperar a tarefa existente em vez de criar outra. Reutilizar esse ID com parâmetros diferentes gera um conflito.

1. 1.

   Verifique primeiro a resposta HTTP

   Trate uma resposta HTTP sem sucesso antes de ler o corpo como um resultado de tarefa. Verifique o status e corrija o erro de requisição informado.

2. 2.

   Consulte a tarefa até sua conclusão

   A criação aguarda até 15 segundos por padrão; reserve tempo extra no timeout do cliente para a sobrecarga de rede. Se o status for pending ou solving, consulte a tarefa com GET /v1/tasks/:id. As consultas GET não aguardam por padrão; para long polling, passe waitMs com um valor de até 15000 como parâmetro de consulta da URL, não como campo JSON. Pare de consultar em ready ou failed. Para failed, inspecione errorCode e error antes de decidir se faz sentido tentar novamente.

3. 3.

   Use a solução pronta

   Envie solution.token ao destino pretendido — não o ID da tarefa. Use os valores retornados de userAgent e secChUa, junto com o proxy bem-sucedido. Não troque de IP nem substitua a identidade de navegador por outra sem relação entre a resolução e o envio.

Um token pronto não comprova uma pontuação específica de reCAPTCHA nem a aceitação pelo destino. O reCAPTCHA v3 produz uma pontuação de risco e uma ação que o destino avalia no backend; verifique a resposta do destino à requisição que envia o token.