Resolva reCAPTCHA Enterprise com Java
Use o HttpClient do Java para solicitar um token e o Gson para ler a resposta JSON. Este exemplo chama a API REST, aguarda a conclusão da tarefa e retorna a solução do reCAPTCHA Enterprise.
Nesta página
Configure o site e o ambiente
Use Java 21 ou posterior. Crie no console um perfil de site ativo para o destino e, em seguida, defina SOLVETHREE_API_KEY e SOLVETHREE_PROXY no ambiente que inicia o Java.
Substitua accounts.example.com pelo hostname do seu perfil e login pela ação usada pela página. O campo site recebe um hostname, sem esquema ou caminho.
Salve e execute Solve.java
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.*;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.util.UUID;
public class Solve {
static final HttpClient HTTP = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(15)).build();
static final String KEY = System.getenv("SOLVETHREE_API_KEY");
static JsonObject api(String path, JsonObject body, long deadline) throws Exception {
long remaining = deadline - System.nanoTime();
if (remaining <= 0) throw new IllegalStateException("Keep the task ID and resume polling");
var builder = HttpRequest.newBuilder(URI.create("https://api.solvethree.com/v1" + path))
.timeout(Duration.ofNanos(Math.min(remaining, Duration.ofSeconds(30).toNanos())))
.header("Authorization", "Bearer " + KEY)
.header("Content-Type", "application/json");
if (body == null) builder.GET();
else builder.POST(HttpRequest.BodyPublishers.ofString(body.toString()));
var response = HTTP.send(builder.build(), HttpResponse.BodyHandlers.ofString());
if (response.statusCode() < 200 || response.statusCode() >= 300)
throw new IllegalStateException("API HTTP " + response.statusCode());
return JsonParser.parseString(response.body()).getAsJsonObject();
}
public static void main(String[] args) throws Exception {
String proxy = System.getenv("SOLVETHREE_PROXY");
if (KEY == null || proxy == null) throw new IllegalArgumentException("Set the API key and proxy");
var input = new JsonObject();
input.addProperty("site", "accounts.example.com");
input.addProperty("action", "login");
input.addProperty("proxy", proxy);
input.addProperty("requestId", UUID.randomUUID().toString());
// Save input before creation if the task must be recovered after restart.
long deadline = System.nanoTime() + Duration.ofSeconds(180).toNanos();
var task = api("/tasks?waitMs=0", input, deadline);
while (task.get("status").getAsString().equals("pending") || task.get("status").getAsString().equals("solving")) {
String id = URLEncoder.encode(task.get("id").getAsString(), StandardCharsets.UTF_8);
task = api("/tasks/" + id + "?waitMs=15000", null, deadline);
if (task.get("status").getAsString().equals("pending") || task.get("status").getAsString().equals("solving"))
Thread.sleep(1000);
}
if (!task.get("status").getAsString().equals("ready"))
throw new IllegalStateException("Task failed: " + task.get("errorCode")
+ ": " + task.get("error"));
var solution = task.getAsJsonObject("solution");
// Submit solution.token with userAgent/secChUa and the original proxy.
System.out.println("Ready task: " + task.get("id").getAsString());
}
}No diretório que contém Solve.java, baixe o JAR do Gson, compile e execute:
curl --fail --location --output gson-2.15.0.jar \
https://repo.maven.apache.org/maven2/com/google/code/gson/gson/2.15.0/gson-2.15.0.jar
javac -cp gson-2.15.0.jar Solve.java
java -cp .:gson-2.15.0.jar SolveEsses comandos usam o separador de classpath do macOS/Linux, :. No Windows, use ; entre o diretório atual e o JAR do Gson.
Leia o token do resultado
A criação usa waitMs=0. O loop consulta o mesmo ID de tarefa enquanto o status é pending ou solving e termina em ready ou failed. Cada GET pode aguardar até 15 segundos; o chamador tem um limite total de 180 segundos.
Leia o token com solution.get("token").getAsString(). Use os valores retornados de userAgent e secChUa na requisição ao destino, pelo mesmo proxy. O programa exibe o ID da tarefa, não o token.
Verifique a resposta do destino após o envio. Uma tarefa pronta indica que uma solução foi gerada; isso não comprova que o aplicativo a aceitou.
Erros e requisições interrompidas
A função auxiliar interrompe a execução ao receber uma resposta HTTP sem sucesso. Uma tarefa com falha terminal informa errorCode e error, e a resolução com falha é reembolsada. Use a referência de erros da API para decidir o que corrigir.
Salve o requestId gerado e os parâmetros exatos se precisar de recuperação após reinícios. Se a criação atingir o timeout, reenvie esses parâmetros com o mesmo ID. Se você já tiver um ID de tarefa, consulte-a. Reiniciar este programa cria outro UUID e pode criar outra tarefa cobrável.
Fontes e referência da API
Execute sua primeira tarefa.
Comece com $5 em créditos no espaço de trabalho.