الأخطاء وإعادة المحاولة

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");}

الرفض من الواجهة البرمجية يرمي OpenEmailApiException، وغياب أي استجابة يرمي OpenEmailNetworkException. كلاهما مشتق من OpenEmailException، فتلتقط catch واحدة أيًّا منهما، ويختار مرشح when النوع.

الخطأ في الاستدعاء نفسه، مثل مفتاح غير صحيح أو معرّف فارغ، يرمي 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 بدقيقة أو أقل، وينتظر العميل تلك المدة.
• —الاتصال الذي يفشل أو تنتهي مهلته تُعاد محاولته بالطريقة نفسها.

الإرسال الذي تُعاد محاولته يحمل مفتاح عدم التكرار نفسه في كل مرة، فتعيد الواجهة البرمجية الرسالة الأولى بدل إرسال ثانية.