Перейти к документации
Java

SDK для Java

Официальный клиент Java для API OpenEmail. Один артефакт без зависимостей и по одному методу на каждый эндпоинт.

Что это

Один артефакт для всего API: от отправки, шаблонов и отслеживания до цепочек, контактов, доменов, вебхуков и одноразовых ящиков. В нём есть метод для каждого метода TypeScript SDK под тем же именем, класс исключения для каждого вида отказа, повторы, которые не могут продублировать отправку, и проверка подписи вебхука. Ему нужна Java 17 или новее и больше ничего: запросы идут через java.net.http.HttpClient, а чтение и запись JSON у него свои.

<dependency>    <groupId>uk.openemail</groupId>    <artifactId>openemail</artifactId>    <version>0.0.1</version></dependency>
SendEmail.java
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"));    }}

Куда идти дальше

Он оборачивает тот же API, что и все остальные клиенты

Всё здесь является той же поверхностью, которую описывает справочник API и оборачивает TypeScript SDK, поэтому читайте справочник API, чтобы узнать, что делает конечная точка, а эти страницы, чтобы узнать, как вызвать её из Java. У каждого метода TypeScript есть двойник в Java, и проверка паритета пакета запускает оба с одинаковыми аргументами и завершается неудачей, если они не отправляют байт в байт один и тот же запрос.