Por que a solvethree usa um perfil de site em vez de um campo websiteKey
O solvethree mantém a chave de site do reCAPTCHA e a configuração da página em um perfil de site. A requisição da tarefa fornece o hostname em site, a ação de execução em action e um proxy — não websiteKey ou websiteURL.
Se você está migrando de outra API, não basta renomear campos. Primeiro, configure um perfil ativo no seu espaço de trabalho; enviar um hostname, uma ação ou uma chave de site não cria um perfil.
Nesta página
Configure a chave do site e a página no console
- 1.
Abra Adicionar um site
Acesse Perfis de site e selecione Adicionar um site. Insira a URL HTTPS da página de destino. A tarefa usará o hostname dela, não essa URL completa. Informe a URL de navegação opcional e o valor de Referer se forem necessários para a configuração da página.
- 2.
Escolha o tipo e confira a chave do site
Selecione Enterprise v3 para uma integração reCAPTCHA Enterprise ou Regular v3 para o reCAPTCHA v3 comum. O formulário pode detectar automaticamente a chave do site; você pode substituí-la informando um valor no campo opcional Chave do site.
- 3.
Defina a ação de captura
A ação de captura é obrigatória. Para a requisição abaixo, configure um perfil com a ação de captura
login. Perfis de sistema revisados podem preencher a configuração conhecida da página e a ação de captura sem uma coleta ao vivo; leia a explicação do formulário sobre a ação escolhida. - 4.
Envie e aguarde a ativação
Selecione Adicionar site. Os envios podem passar pelos estados na fila, em captura, em validação ou em revisão antes de se tornarem ativos; não há duração garantida para a captura. Algumas contas exibem Adicionar crédito para continuar. Se a captura falhar, inspecione o motivo antes de tentar novamente.
Use um perfil por combinação de hostname, ação de captura e tipo de reCAPTCHA. Uma correspondência exata da ação de execução seleciona o perfil correspondente. Outras ações de execução exigem um único alvo de captura inequívoco, então não presuma que um único perfil para um hostname cobre todas as ações.
Envie a requisição de tarefa sem objeto de encapsulamento
Quando o perfil estiver ativo, envie este objeto diretamente como corpo JSON para POST /v1/tasks. Autentique-se com Authorization: Bearer seguido da chave de API do seu espaço de trabalho e mantenha essa chave no servidor.
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}siteé o hostname: sem esquema, caminho ou query. A URL completa da página deve ficar no perfil do console.actioné a ação de execução desta tarefa. Aqui,logincorresponde à ação de captura configurada acima.proxyfornece o proxy para a resolução. É obrigatório informar exatamente um dos camposproxyouproxyCandidates; não envie ambos.requestIdé opcional. Se a criação exceder o tempo limite, reenviar a mesma requisição com o mesmo ID retorna a tarefa existente. Alterar os dados da tarefa e reutilizar esse ID gera conflito.
Não reutilize websiteKey, websiteURL, type ou url do formato de requisição da API anterior. Para reCAPTCHA, o valor padrão de recaptchaType é enterprise-v3, por isso o exemplo o omite. O v3 comum usa recaptchaType definido como v3.
Fontes e referência da API
Execute sua primeira tarefa.
Comece com $5 em créditos no espaço de trabalho.