SDKs

Java

Patrones idiomáticos de Java para la Thunderbit Open API

Usa java.net.http.HttpClient (incorporado, Java 11+). Para una ergonomía más rica — connection pooling, reintentos — combínalo con OkHttp + Jackson.

Configuración

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

private static final String API = "https://openapi.thunderbit.com/openapi/v1";
private static final HttpClient CLIENT = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(10))
    .build();

private static HttpRequest.Builder request(String path) {
    return HttpRequest.newBuilder()
        .uri(URI.create(API + path))
        .header("Authorization", "Bearer " + System.getenv("THUNDERBIT_API_KEY"))
        .header("Content-Type", "application/json")
        .timeout(Duration.ofSeconds(60));
}

Distill de una página

String body = "{\"url\":\"https://thunderbit.com/playground\"}";
HttpResponse<String> res = CLIENT.send(
    request("/distill").POST(HttpRequest.BodyPublishers.ofString(body)).build(),
    HttpResponse.BodyHandlers.ofString()
);
if (res.statusCode() >= 400) throw new RuntimeException(res.body());

Extract de datos estructurados

String body = """
{
  "url": "https://example.com/product/iphone-15-pro",
  "schema": {
    "type": "object",
    "properties": {
      "name":  { "type": "string" },
      "price": { "type": "number" }
    },
    "required": ["name", "price"]
  }
}
""";
HttpResponse<String> res = CLIENT.send(
    request("/extract").POST(HttpRequest.BodyPublishers.ofString(body)).build(),
    HttpResponse.BodyHandlers.ofString()
);

Parsea la respuesta con Jackson o Gson en tu tipo de dominio.

Batch + webhook

String body = """
{
  "urls": ["https://example.com/page1", "https://example.com/page2"],
  "webhook": {
    "url":    "https://your-server.com/webhook",
    "secret": "%s"
  }
}
""".formatted(System.getenv("WEBHOOK_SECRET"));

HttpResponse<String> res = CLIENT.send(
    request("/batch/distill").POST(HttpRequest.BodyPublishers.ofString(body)).build(),
    HttpResponse.BodyHandlers.ofString()
);

Verifica la firma del webhook en tu handler — ver Webhooks.

Un SDK oficial de Java está en desarrollo — vuelve pronto.