कॉन्फ़िगरेशन

OpenEmail client = OpenEmail.builder()    .apiKey(System.getenv("OPENEMAIL_API_KEY"))    .baseUrl("https://api.openemail.uk")    .timeout(Duration.ofSeconds(30))    .maxRetries(2)    .header("X-Team", "billing")    .build(); System.out.println(client.mode());

जो कुछ आप छोड़ देते हैं वह एनवायरनमेंट से पढ़ा जाता है: OPENEMAIL_API_KEY, फिर OPENEMAIL_ACCESS_TOKEN, और OPENEMAIL_BASE_URL। client.mode() बताता है कि कुंजी live कुंजी है या test कुंजी।

क्वेरी पैरामीटर और कॉल की सेटिंग एक RequestOptions में जाती हैं, जो आर्ग्युमेंट के बाद पास किया जाता है। इसमें apiKey, idempotencyKey, timeout, limit और cursor के लिए मेथड हैं, और set बाकी हर विकल्प को उसी नाम से लेता है जो API इस्तेमाल करता है। हर मेथड वही विकल्प स्वीकार करता है जो उसकी संदर्भ प्रविष्टि में सूचीबद्ध हैं, और जो विकल्प लागू नहीं होता वह कुछ भी भेजे जाने से पहले अस्वीकार कर दिया जाता है।

RequestOptions options = RequestOptions.of("folder", "inbox")    .apiKey(System.getenv("OPENEMAIL_API_KEY"))    .timeout(Duration.ofSeconds(5))    .limit(50); Page threads = client.threads().list(options); System.out.println(threads.size());

एक RequestOptions अपरिवर्तनीय है: हर मेथड एक नया लौटाता है, इसलिए कोई साझा मान उस कोड से कभी नहीं बदल सकता जो उसमें कुछ जोड़ता है। थ्रेड को इंटरप्ट करने से प्रतीक्षा कर रही कॉल रुक जाती है।

• —ऐसी कुंजी जो oe_live_ या oe_test_ से शुरू नहीं होती, और एक्सेस टोकन के साथ दी गई कुंजी।
• —सादे http: पर क्रेडेंशियल भेजना, जब तक सर्वर इसी मशीन पर localhost, किसी 127.x.x.x पते या ::1 पर न हो।
• —0.0.0.0 पर बेस URL, जो वह पता है जिस पर सर्वर सुनता है। उसी पोर्ट के साथ 127.0.0.1 इस्तेमाल करें।
• —खाली id, या सिर्फ़ बिंदुओं से बना id, जिसे URL पार्सर हटा देगा।
• —किसी रीडायरेक्ट का पीछा करना। डिफ़ॉल्ट HTTP क्लाइंट कभी किसी रीडायरेक्ट का पीछा नहीं करता, इसलिए क्रेडेंशियल कभी किसी दूसरे होस्ट तक नहीं जाता।

client.raw().request किसी भी पाथ को क्लाइंट के क्रेडेंशियल, बेस URL, टाइमआउट और रीट्राई नीति के साथ कॉल करता है। पाथ एक ही / से शुरू होना चाहिए, और जो पाथ बेस URL के ओरिजिन से बाहर जाता है वह अस्वीकार कर दिया जाता है।

Object label = client.raw().request("POST", "/labels", Body.of("name", "Invoices")); System.out.println(label);