التثبيت

<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> تحتفظ مفاتيحها بأسماء الواجهة البرمجية، لذا يُكتب scheduledAt هنا كما في مرجع الواجهة البرمجية. تبني Body.of جسمًا يحافظ على الترتيب الذي كتبته به ويقبل القيم null. والاستجابة هي JSON بعد فك ترميزه على هيئة Map<String, Object>، لذا تقرأ email.get("id") المعرّف.

Java 17 فما فوق، بأي لغة تعمل على JVM. ليس لملف jar أي اعتمادية، وهو يسمّي وحدته uk.openemail للتطبيقات الموجودة على مسار الوحدات.

العميل غير قابل للتغيير ويمكن مشاركته بأمان بين الخيوط. أنشئ واحدًا عند بدء التطبيق واحتفظ به: فهو يحمل HttpClient واحدًا يعيد استخدام اتصالاته.