Installation
Ein Artefakt auf Maven Central, Java 17 und neuer, ohne Abhängigkeiten.
Installation
Die aktuelle Version ist 0.0.1. Sie hat eine Methode für jede Methode des TypeScript-SDK, und die Paritätsprüfung des Pakets lässt den Build scheitern, wenn eine fehlt oder eine andere Anfrage sendet.
<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 FirstEmail { 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")); }}new OpenEmail() liest den Schlüssel aus OPENEMAIL_API_KEY, sodass der Code keine Zugangsdaten enthält. Verwenden Sie OpenEmail.builder().apiKey(...), wenn Ihre Konfiguration an anderer Stelle liegt.
Ein Anfragekörper ist eine Map<String, Object>, deren Schlüssel die Namen der API behalten, sodass scheduledAt hier genauso geschrieben wird wie in der API-Referenz. Body.of baut eine, die die Reihenfolge behält, in der Sie sie geschrieben haben, und null-Werte annimmt. Eine Antwort ist das dekodierte JSON als Map<String, Object>, sodass email.get("id") die ID liest.
Dass send zurückkehrt, heißt nicht, dass die Nachricht verschickt ist. Ein geplanter oder abbrechbarer Versand kommt als queued oder scheduled zurück und steht erst später fest. Lesen Sie status, nicht die Tatsache, dass der Aufruf zurückgekehrt ist.
Wo es läuft
Java 17 und neuer, in jeder JVM-Sprache. Das Jar hat keine Abhängigkeit und nennt sein Modul uk.openemail für Anwendungen auf dem Modulpfad.
Der Client ist unveränderlich und kann gefahrlos zwischen Threads geteilt werden. Bauen Sie einen, wenn die Anwendung startet, und behalten Sie ihn: Er hält einen HttpClient, der seine Verbindungen wiederverwendet.
Der Client trägt einen Workspace-API-Schlüssel, der Mail senden und das Postfach lesen kann. Er gehört daher auf einen Server, in einen Job oder in ein Tool, das auf Ihrem eigenen Rechner läuft. Bewahren Sie den Schlüssel in einer Umgebungsvariable oder in einem Secret-Speicher auf, nie im Code.