SDK de Java
El cliente oficial de Java para la API de OpenEmail. Un solo artefacto sin dependencias y un método por cada endpoint.
Qué es
Un solo artefacto para toda la API, desde el envío, las plantillas y el seguimiento hasta los hilos, los contactos, los dominios, los webhooks y los buzones desechables. Tiene un método para cada método del SDK de TypeScript con el mismo nombre, una clase de excepción para cada clase de rechazo, reintentos que no pueden duplicar un envío y un verificador de firmas de webhook. Necesita Java 17 o posterior y nada más: las peticiones pasan por java.net.http.HttpClient, y el lector y el escritor de JSON son propios.
<dependency> <groupId>uk.openemail</groupId> <artifactId>openemail</artifactId> <version>0.0.1</version></dependency>import java.util.Map;import uk.openemail.Body;import uk.openemail.OpenEmail; public final class SendEmail { public static void main(String[] args) { OpenEmail client = new OpenEmail(); Map<String, Object> email = client.emails().send(Body.of( "from", "Acme Billing <[email protected]>", "to", "[email protected]", "subject", "Your September invoice", "html", "<p>Invoice attached.</p>" )); System.out.println(email.get("id") + " " + email.get("status")); }}A dónde ir
Envuelve la misma API que todos los demás clientes
Todo lo que hay aquí es la superficie que documenta la referencia de la API y que envuelve el SDK de TypeScript, así que lee la referencia de la API para saber qué hace un endpoint y estas páginas para saber cómo llamarlo desde Java. Cada método de TypeScript tiene su gemelo en Java, y la comprobación de paridad del paquete ejecuta ambos con los mismos argumentos y falla si no envían, byte por byte, la misma petición.