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

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 पर न हो।
• —0.0.0.0 पर बेस URL, जो वह पता है जिस पर सर्वर सुनता है। उसी पोर्ट के साथ 127.0.0.1 इस्तेमाल करें।
• —खाली id, या सिर्फ़ बिंदुओं से बना id, जिसे URL पार्सर हटा देगा।
• —रीडायरेक्ट का पालन करना। डिफ़ॉल्ट HTTP क्लाइंट उसे एरर के रूप में लौटाता है, इसलिए क्रेडेंशियल कभी किसी दूसरे होस्ट तक नहीं जाता।

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

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