الإعداد

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 أي خيار آخر بالاسم الذي تستخدمه الواجهة البرمجية. تقبل كل دالة الخيارات التي يسردها مدخلها في المرجع، والخيار الذي لا ينطبق يُرفض قبل إرسال أي شيء.

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.
• —عنوان URL أساسي على 0.0.0.0، وهو عنوان يستمع عليه الخادم. استخدم 127.0.0.1 مع المنفذ نفسه.
• —معرّف فارغ، أو معرّف مكوّن من نقاط فقط، كان محلل عناوين URL سيحذفه.
• —تتبّع إعادة التوجيه. عميل HTTP الافتراضي لا يتبع أي إعادة توجيه، فلا تنتقل بيانات الاعتماد أبدًا إلى مضيف آخر.

تستدعي client.raw().request أي مسار ببيانات اعتماد العميل وعنوانه الأساسي ومهلته وسياسة إعادة المحاولة لديه. يجب أن يبدأ المسار بعلامة / واحدة، والمسار الذي يخرج عن أصل العنوان الأساسي يُرفض.

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