Teste o solvethree no Postman

1. 1.

   Importe o JSON baixado

   No Postman, escolha Importar e selecione o arquivo da coleção. Ele contém Criar tarefa e Consultar tarefa com autorização Bearer herdada e placeholders de variáveis.

2. 2.

   Verifique o perfil do site

   Seu espaço de trabalho precisa de um perfil ativo para o hostname de destino. Configure-o no console antes de testar; enviar um hostname e uma ação não cria um perfil. Consulte configuração do perfil do site.

3. 3.

   Configure valores privados de ambiente

   Crie e selecione um ambiente para este teste. Preencha os valores abaixo de forma privada, incluindo quaisquer credenciais do proxy. Não coloque segredos diretamente na coleção nem exporte segredos preenchidos.

4. 4.

   Configure a autorização Bearer

   No nível da coleção, selecione Bearer Token e faça referência a uma variável privada de ambiente que contenha a chave de API do seu espaço de trabalho. Mantenha ambas as requisições configuradas para herdar a autorização. A API espera Authorization: Bearer seguido dessa chave.

Abra Criar tarefa. Ela envia um POST para https://api.solvethree.com/v1/tasks com um corpo JSON bruto preenchido a partir do ambiente selecionado.

{
  "site": "{{SITE}}",
  "action": "{{ACTION}}",
  "proxy": "{{PROXY}}",
  "requestId": "{{REQUEST_ID}}"
}

Esta requisição usa reCAPTCHA Enterprise v3 por padrão. Não adicione os campos type nem url. Ela fornece um único proxy, portanto não adicione também proxyCandidates: é obrigatório usar exatamente um desses campos.

Defina REQUEST_ID antes de enviar e clique em Enviar uma vez. Verifique a resposta HTTP primeiro. Se ela não indicar sucesso, inspecione o erro da requisição em vez de tratar o corpo como uma resposta bem-sucedida da tarefa. Corrija entradas inválidas em vez de enviá-las repetidamente sem alterações.

Se a resposta de criação for bem-sucedida, copie o id retornado para o valor privado de ambiente TASK_ID. Não clique em Criar tarefa novamente só para verificar o progresso.

Abra Consultar tarefa e confirme que TASK_ID contém o ID da tarefa retornado. Esta requisição usa GET /v1/tasks/:id na mesma API. Envie-a manualmente, verifique a resposta HTTP e depois inspecione o status da tarefa.

HTTP 200 ou 201, por si só, não significa que uma solução está pronta; apenas status: ready indica isso. Este teste manual verifica a criação e a consulta da tarefa, não se o site de destino aceita o resultado.

Se você continuar enviando o token de reCAPTCHA ao destino pretendido, use a identidade de navegador retornada em userAgent e secChUa e o proxy que funcionou. Não troque de IP nem misture uma identidade de navegador sem relação com a solução. Um token pronto ainda pode ser rejeitado pelo destino.

Um tempo limite de conexão excedido não prova que a criação falhou. Se você tem o ID da tarefa, consulte-a. Se nunca recebeu o ID, reenvie Criar tarefa com o mesmo REQUEST_ID e as entradas da tarefa inalteradas. Isso recupera a tarefa existente em vez de criar outra tarefa lógica.

Não gere um novo REQUEST_ID só porque a resposta foi perdida. Reutilizar um ID com entradas diferentes da tarefa causa conflito; use um novo ID quando iniciar uma nova tarefa deliberadamente.