الإعداد

client := openemail.New(	openemail.WithAPIKey(os.Getenv("OPENEMAIL_API_KEY")),	openemail.WithBaseURL("https://api.openemail.uk"),	openemail.WithTimeout(30*time.Second),	openemail.WithMaxRetries(2),	openemail.WithHeader("X-Team", "billing"),) if err := client.Err(); err != nil {	return err} fmt.Println(client.Mode(), client.BaseURL())

كل ما تتركه يُقرأ من البيئة: OPENEMAIL_API_KEY، ثم OPENEMAIL_ACCESS_TOKEN، وOPENEMAIL_BASE_URL. تخبرك client.Mode() هل المفتاح مفتاح live أم مفتاح test.

تأخذ كل دالة context.Context أولًا. إلغاؤه يوقف الاستدعاء فورًا، وموعده النهائي يحد الاستدعاء كله بما فيه إعادة المحاولات، أما WithTimeout فيحد كل محاولة. ويعمل WithTimeout أيضًا على استدعاء واحد.

ctx, cancel := context.WithTimeout(ctx, 10*time.Second)defer cancel() thread, err := client.Threads.Get(ctx, "CAHk7pQ2x9LmZ4-mail.example.com", openemail.WithTimeout(5*time.Second))if err != nil {	return err} fmt.Println(thread.Int("messageCount"))

معاملات الاستعلام وإعدادات الاستدعاء دوال تُمرَّر بعد الوسائط، مثل openemail.WithLimit وopenemail.WithCursor وopenemail.WithIdempotencyKey. تقبل كل دالة الخيارات التي يسردها مدخلها في المرجع، والخيار الذي لا ينطبق يُرفض قبل إرسال أي شيء.

page, err := client.Emails.List(ctx,	openemail.WithStatus("failed", "bounced"),	openemail.WithLimit(50),	openemail.WithAPIKey(os.Getenv("OTHER_WORKSPACE_KEY")),)if err != nil {	return err} fmt.Println(len(page.Items), page.HasMore)

• —مفتاح لا يبدأ بـ oe_live_ أو oe_test_، ومفتاح مع رمز وصول معًا.
• —إرسال بيانات اعتماد عبر http: غير المشفر، إلا إذا كان الخادم على هذا الجهاز عند localhost أو عنوان 127.x.x.x أو ::1.
• —عنوان URL أساسي على 0.0.0.0، وهو عنوان يستمع عليه الخادم. استخدم 127.0.0.1 مع المنفذ نفسه.
• —معرّف فارغ، أو معرّف مكوّن من نقاط فقط، كان محلل عناوين URL سيحذفه.
• —اتباع إعادة التوجيه. عميل HTTP الافتراضي يعيدها كخطأ، فلا تنتقل بيانات الاعتماد أبدًا إلى مضيف آخر.

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

label, err := client.Request(ctx, http.MethodPost, "/labels", openemail.Body{"name": "Invoices"})if err != nil {	return err} fmt.Println(label)