SDKs
Java
Pattern Java idiomatici per la Open API di Thunderbit
Usa java.net.http.HttpClient (integrato, Java 11+). Per un'ergonomia più ricca — connection pooling, retry — abbinalo a OkHttp + Jackson.
Configurazione
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 di una pagina
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 di dati strutturati
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()
);Effettua il parsing della risposta con Jackson o Gson nel tuo tipo di 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 nel tuo handler — vedi Webhooks.
Un SDK Java ufficiale è in sviluppo — torna presto a controllare.