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

_, err := client.Emails.Send(ctx, openemail.Body{	"from":    "[email protected]",	"to":      "[email protected]",	"subject": "Your September invoice",	"text":    "Invoice attached.",}) var failure *openemail.Error switch {case err == nil:	fmt.Println("sent")case errors.Is(err, openemail.ErrValidation):	errors.As(err, &failure)	fmt.Println(failure.Code, failure.Param, failure.Message)case errors.Is(err, openemail.ErrRateLimited):	errors.As(err, &failure)	fmt.Println("try again in", failure.RetryAfter)case errors.Is(err, openemail.ErrTimeout):	fmt.Println("no answer in time")default:	return err}

كل إخفاق هو *openemail.Error. تخبرك errors.Is بنوعه، وتعطيك errors.As الخطأ نفسه مع ما قالته الواجهة البرمجية عنه.

السياق الملغى ما زال يطابق context.Canceled، والموعد النهائي الذي انقضى يطابق context.DeadlineExceeded.

• —عمليات القراءة والإرسال وكل كتابة يمكن تكرارها بأمان تُعاد محاولتها، حتى WithMaxRetries مرة. وأي كتابة أخرى تُرسل مرة واحدة.
• —الحالات 408 و500 و502 و503 و504 تُعاد محاولتها مع انتظار يبدأ بنصف ثانية ويتضاعف حتى ثماني ثوانٍ.
• —لا تُعاد محاولة 429 إلا حين يحمل Retry-After بدقيقة أو أقل، وينتظر العميل تلك المدة.
• —الاتصال الذي يفشل أو تنتهي مهلته تُعاد محاولته بالطريقة نفسها.

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