Configure um perfil de site para reCAPTCHA
Configure o site em Perfis de sites e espere o perfil exibir active antes de solicitar um token. Enviar um hostname e uma ação à API de tarefas não cria um perfil.
Nesta página
Adicione o site no console
- 1.
Verifique o espaço de trabalho
Configure o perfil no espaço de trabalho cuja chave de API você usará para criar tarefas. Um perfil em outro espaço de trabalho não basta. Se o console exibir Adicione crédito para continuar, siga essa orientação antes de prosseguir com a configuração.
- 2.
Abra Adicionar um site
Em Perfis de sites, selecione Adicionar um site. Insira a página HTTPS de destino em URL da página. Em Tipo de reCAPTCHA, escolha Enterprise v3 ou Regular v3 conforme a página.
- 3.
Defina os parâmetros de captura
A ação de captura é obrigatória. Use a ação para a qual você pretende solicitar a resolução; se não tiver certeza, encontre a ação do reCAPTCHA primeiro. O formulário também tem os campos opcionais URL de navegação, Chave do site e Valor de Referer. A chave do site pode ser descoberta automaticamente.
- 4.
Envie o formulário
Selecione Adicionar site. Perfis de sistema revisados podem preencher o contrato conhecido da página e a ação de captura sem uma coleta ao vivo; o formulário explica a ação escolhida. Outros envios podem entrar nos estados na fila, capturando, validando ou em revisão.
Verifique o status do perfil resultante. ACTIVE é exibido como active, e esse é o estado necessário para a resolução. Se a captura falhar, o console mostra o motivo e permite tentar novamente.
Solicite um token usando o perfil ativo
Este corpo de tarefa usa o hostname e a ação do perfil:
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}siteé o hostname da URL da página, sem o esquema ou o caminho.actioné a ação da solicitação protegida. Use a ação correspondente ao perfil que você pretende usar.- O valor padrão de
recaptchaTypeéenterprise-v3. Para um perfil Regular v3, defina-o explicitamente comov3. - Substitua o marcador de proxy pelo proxy HTTP(S) que você também usará na solicitação ao destino.
O guia de início rápido em Python e o guia de início rápido em Node.js mostram como enviar a solicitação e usar o resultado.
Corrija um perfil ausente ou inativo
- Nenhum perfil está disponível para a tarefa.
Compare o espaço de trabalho associado à sua chave de API e o hostname da tarefa com o perfil que você configurou.
Experimente: Adicione o perfil do site pretendido no espaço de trabalho que criará a tarefa. Repetir a criação da tarefa não criará o perfil ausente.
- O perfil está na fila, em captura, em validação ou em revisão.
Consulte o estado atual em Perfis de sites.
Experimente: Espere o perfil ficar ativo antes de solicitar uma resolução. Esses estados não substituem um perfil ativo.
- A captura falhou.
Leia o motivo da falha exibido no console.
Experimente: Corrija o problema indicado por esse motivo e tente capturar novamente.
- Um perfil está ativo, mas a ação pretendida ainda não é resolvida.
Compare o hostname, a ação de captura e o tipo de reCAPTCHA. Se a ação de execução for diferente, verifique se existe um único alvo de captura inequívoco.
Experimente: Configure um perfil que corresponda ao hostname, à ação e ao tipo pretendidos, em vez de alterar a tarefa para uma ação sem relação apenas para selecionar um perfil existente.
Fontes e referência da API
Execute sua primeira tarefa.
Comece com $5 em créditos no espaço de trabalho.