एरर और रीट्राई

try{    await client.Emails.SendAsync(new Body    {        ["from"] = "[email protected]",        ["to"] = "[email protected]",        ["subject"] = "Your September invoice",        ["text"] = "Invoice attached.",    });}catch (OpenEmailApiException error) when (error.IsValidation){    Console.Error.WriteLine($"{error.Code} {error.Param} {error.Message}");}catch (OpenEmailApiException error) when (error.IsRateLimited){    Console.Error.WriteLine($"try again in {error.RetryAfterSeconds} seconds");}catch (OpenEmailNetworkException error) when (error.IsTimeout){    Console.Error.WriteLine("no answer in time");}

API का इनकार OpenEmailApiException थ्रो करता है, और कोई जवाब न आना OpenEmailNetworkException थ्रो करता है। दोनों OpenEmailException से निकले हैं, इसलिए एक ही catch दोनों को पकड़ लेता है, और when फ़िल्टर तरह चुनता है।

खुद कॉल में हुई गलती, जैसे गलत बनावट वाली कुंजी या खाली id, कुछ भी भेजे जाने से पहले ArgumentException थ्रो करती है। रद्द किया गया टोकन OperationCanceledException थ्रो करता है, और जाँच में विफल वेबहुक डिलीवरी OpenEmailWebhookException थ्रो करती है।

एक्सेस टोकन किसी व्यक्ति की ओर से काम करता है, इसलिए किसी संवेदनशील बदलाव से पहले, जैसे डोमेन हटाना, उससे वही सत्यापन कोड माँगा जाता है जो वेब ऐप माँगता है। एक कोड माँगें, उसे जाँचें, फिर अनुरोध दोबारा करें। API कुंजियों से कभी कोड नहीं माँगा जाता।

var domainId = "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f"; try{    await client.Domains.DeleteAsync(domainId);}catch (OpenEmailApiException error) when (error.IsStepUpRequired){    var challenge = await client.Security.BeginStepUpAsync();     Console.WriteLine($"Enter the code sent by {challenge["method"]}");     await client.Security.VerifyStepUpAsync(new Body { ["code"] = Console.ReadLine()?.Trim() });    await client.Domains.DeleteAsync(domainId);}

• —पढ़ने वाली कॉल, भेजने वाली कॉल और हर वह लिखने वाली कॉल जिसे दोहराना सुरक्षित है, MaxRetries बार तक दोबारा आज़माई जाती है। कोई भी अन्य लिखने वाली कॉल एक बार भेजी जाती है।
• —स्टेटस 408, 500, 502, 503 और 504 को ऐसे इंतज़ार के साथ दोबारा आज़माया जाता है जो आधे सेकंड से शुरू होता है और आठ सेकंड तक दोगुना होता जाता है।
• —429 को तभी दोबारा आज़माया जाता है जब उसके साथ एक मिनट या उससे कम का Retry-After हो, और क्लाइंट उतनी देर प्रतीक्षा करता है।
• —जो कनेक्शन विफल होता है या जिसका टाइमआउट हो जाता है उसे भी इसी तरह दोबारा आज़माया जाता है।

दोबारा आज़माई गई भेजने वाली कॉल हर बार वही आइडेम्पोटेंसी कुंजी रखती है, इसलिए API दूसरा संदेश भेजने के बजाय पहला संदेश दोहराता है।