نصب

<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() کلید را از OPENEMAIL_API_KEY می‌خواند، پس کد هیچ اعتبارنامه‌ای در خود ندارد. وقتی پیکربندی‌تان جای دیگری است از OpenEmail.builder().apiKey(...) استفاده کنید.

بدنهٔ درخواست یک Map<String, Object> است که کلیدهایش نام‌های API را نگه می‌دارند، پس scheduledAt اینجا همان‌طور نوشته می‌شود که در مرجع API. Body.of بدنه‌ای می‌سازد که ترتیب نوشتن شما را نگه می‌دارد و مقدار null را می‌پذیرد. پاسخ همان JSON رمزگشایی‌شده به شکل Map<String, Object> است، پس email.get("id") شناسه را می‌خواند.

Java 17 به بالا، در هر زبان JVM. فایل jar هیچ وابستگی ندارد و برای برنامه‌هایی که روی مسیر ماژول هستند، ماژول خود را uk.openemail می‌نامد.

کلاینت تغییرناپذیر است و می‌توان آن را با خیال راحت میان ریسمان‌ها به اشتراک گذاشت. هنگام شروع برنامه یکی بسازید و نگهش دارید: یک HttpClient دارد که اتصال‌هایش را دوباره به کار می‌برد.