SDK de Java
O cliente oficial de Java para a API do OpenEmail. Um só artefacto sem dependências e um método para cada endpoint.
O que é
Um só artefacto para toda a API, do envio, dos modelos e do rastreio até às conversas, aos contactos, aos domínios, aos webhooks e às caixas descartáveis. Tem um método para cada método do SDK de TypeScript com o mesmo nome, uma classe de exceção para cada género de recusa, novas tentativas que não podem duplicar um envio e um verificador de assinaturas de webhook. Precisa de Java 17 ou posterior e de mais nada: os pedidos passam por java.net.http.HttpClient, e o leitor e o escritor de JSON são próprios.
<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")); }}Por onde ir
Envolve a mesma API que todos os outros clientes
Tudo o que aqui está é a superfície que a referência da API documenta e que o SDK de TypeScript envolve, por isso leia a referência da API para saber o que um endpoint faz e estas páginas para saber como chamá-lo a partir de Java. Cada método de TypeScript tem um gémeo em Java, e a verificação de paridade do pacote executa ambos com os mesmos argumentos e falha se não enviarem, byte a byte, o mesmo pedido.