इंस्टॉल
Maven Central पर एक आर्टिफ़ैक्ट, Java 17 और उससे ऊपर, बिना किसी डिपेंडेंसी के।
इंस्टॉल
मौजूदा रिलीज़ 0.0.1 है। इसमें TypeScript SDK के हर मेथड के लिए एक मेथड है, और जब कोई मेथड छूट जाए या अलग अनुरोध भेजे तो पैकेज की समानता जाँच बिल्ड को विफल कर देती है।
<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") आईडी पढ़ता है।
send का लौट आना इसका मतलब नहीं कि संदेश चला गया। शेड्यूल किया गया या रद्द किया जा सकने वाला send queued या scheduled लौटता है और बाद में तय होता है। status पढ़ें, न कि यह कि कॉल लौट आई।
यह कहाँ चलता है
Java 17 और उससे ऊपर, किसी भी JVM भाषा में। jar की कोई डिपेंडेंसी नहीं है, और मॉड्यूल पाथ पर चलने वाले एप्लिकेशन के लिए यह अपने मॉड्यूल का नाम uk.openemail रखता है।
क्लाइंट अपरिवर्तनीय है और थ्रेड के बीच सुरक्षित रूप से साझा किया जा सकता है। एप्लिकेशन शुरू होते समय एक बनाएँ और उसे रखें: इसके पास एक HttpClient होता है, जो अपने कनेक्शन दोबारा इस्तेमाल करता है।
क्लाइंट एक वर्कस्पेस API कुंजी लिए चलता है जो मेल भेज सकती है और मेलबॉक्स पढ़ सकती है, इसलिए इसकी जगह सर्वर पर, किसी जॉब में या आपकी अपनी मशीन पर चलने वाले टूल में है। कुंजी को किसी एनवायरनमेंट वेरिएबल या secrets स्टोर में रखें, कोड में कभी नहीं।