Por que a solvethree usa um perfil de site em vez de um campo websiteKey

Por solvethree3 min de leitura

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. 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. 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. 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. 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.

reCAPTCHA Enterprise · estrutura da requisição
{
  "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, login corresponde à ação de captura configurada acima.
  • proxy fornece o proxy para a resolução. É obrigatório informar exatamente um dos campos proxy ou proxyCandidates; 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.

Execute sua primeira tarefa.

Comece com $5 em créditos no espaço de trabalho.

Criar um espaço de trabalho
Por que a solvethree usa um perfil de site em vez de um campo websiteKey · solvethree