Sua primeira resolução de CAPTCHA na solvethree

1. 1.

   Cadastre-se e configure seu espaço de trabalho

   Comece pelo cadastro. Use o mesmo espaço de trabalho para sua chave de API, seu perfil de site e seu crédito.

2. 2.

   Crie uma chave

   Abra Chaves de API no console. Selecione Criar chave de API, insira um Nome da chave e selecione Criar chave.

3. 3.

   Salve o segredo

   Copie o segredo exibido em Salve sua chave de API e armazene-o com segurança antes de selecionar Salvei esta chave. Revelar prefixos não recuperará o segredo completo depois. Mantenha a chave no servidor, não no código do navegador.

O crédito de boas-vindas é de $5. Se precisar adicionar fundos, o depósito mínimo é de $10. reCAPTCHA custa $2.00 por 1,000 resoluções; uma tarefa pronta é cobrada e uma resolução com falha é reembolsada.

1. 1.

   Adicione a página de destino

   Abra Perfis de site e selecione Adicionar um site. Insira a URL da página HTTPS do destino e escolha Enterprise v3.

2. 2.

   Defina a ação de captura

   Use a ação exigida pela operação que você está integrando. O exemplo de requisição abaixo usa login, portanto use esse valor somente se for a ação real do destino. Adicione um perfil para cada combinação de hostname, ação de captura e tipo de reCAPTCHA.

3. 3.

   Aguarde o status ativo

   Selecione Adicionar site. Algumas contas verão primeiro Adicione crédito para continuar. Dependendo do envio, o perfil pode passar por estados de captura, validação ou revisão. Continue somente quando ele estiver ativo; não há duração de captura garantida. Se a captura falhar, leia o motivo antes de tentar novamente.

Enviar um hostname e uma ação em uma tarefa não cria um perfil. Para esta primeira resolução, use na tarefa a ação de captura exata do perfil. Consulte a configuração de perfil de site para saber mais sobre campos opcionais e seleção de ação.

Envie o corpo a seguir para POST https://api.solvethree.com/v1/tasks. Autentique com o cabeçalho Authorization usando Bearer seguido da sua chave de API do espaço de trabalho.

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

• Substitua site pelo hostname do destino, não pela URL completa da página. Substitua action pela ação selecionada para sua primeira resolução.
• Substitua proxy pela URL e pelas credenciais do seu proxy HTTP. Esta requisição usa um proxy; não envie também proxyCandidates.
• Escolha um requestId para esta requisição lógica e guarde-o junto com os dados de entrada enviados. Ele aceita de 1–64 letras ASCII, números, sublinhados ou hífens.
• Omita type e url. Quando recaptchaType é omitido, a requisição usa Enterprise v3 por padrão.

Para uma implementação completa em Python, use reCAPTCHA Enterprise em Python. A requisição aqui mostra os valores que você precisa preparar primeiro.

Guarde o ID de tarefa retornado na criação. Consulte a tarefa com GET https://api.solvethree.com/v1/tasks/:id, substituindo :id por esse ID e usando a mesma autenticação Bearer.

• Verifique se houve uma resposta HTTP sem sucesso antes de ler o corpo como uma resposta de tarefa bem-sucedida.
• Enquanto o status for pending ou solving, continue consultando periodicamente. Nenhum desses status contém uma solução utilizável.
• Quando o status for ready, pare de consultar e leia solution.
• Quando o status for failed, pare de consultar e examine errorCode e error. A resolução com falha é reembolsada.

Uma resposta de tarefa pronta tem este formato. Esses valores de token e identidade de navegador são ilustrativos, não uma solução real.

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

1. 1.

   Envie o token, não o ID da tarefa

   Coloque solution.token onde o destino desejado espera receber seu token de reCAPTCHA. Examine a requisição de saída para garantir que ela não esteja enviando o ID da tarefa ou um token antigo.

2. 2.

   Use a identidade de navegador retornada

   Use solution.userAgent e solution.secChUa na requisição ao destino, junto com o mesmo proxy fornecido para esta resolução. Não os misture com uma identidade de navegador não relacionada nem envie o token para outra URL de destino.

3. 3.

   Verifique a resposta do destino

   Confirme que o destino aceitou a operação desejada. Uma tarefa pronta significa que solvethree gerou uma solução; isso não garante que o destino aceite sua requisição subsequente.

Antes de iniciar um lote, faça com que o destino aceite esta requisição individual. Se ela for rejeitada, verifique o token enviado, a identidade de navegador, o proxy e a URL de destino antes de comprar mais resoluções.