خطاها و تلاش دوباره

_, 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 خود خطا را می‌دهد، همراه با آنچه API درباره‌اش گفته است.

زمینهٔ لغوشده همچنان با context.Canceled مطابقت دارد، و سررسیدِ گذشته با context.DeadlineExceeded مطابقت دارد.

• —خواندن‌ها، ارسال‌ها و هر نوشتنی که تکرارش بی‌خطر است دوباره امتحان می‌شوند، تا WithMaxRetries بار. هر نوشتن دیگری یک بار فرستاده می‌شود.
• —وضعیت‌های 408، 500، 502، 503 و 504 با انتظاری دوباره امتحان می‌شوند که از نیم ثانیه شروع می‌شود و تا هشت ثانیه دو برابر می‌شود.
• —یک 429 فقط وقتی دوباره امتحان می‌شود که Retry-After یک دقیقه یا کمتر داشته باشد، و کلاینت همان‌قدر صبر می‌کند.
• —اتصالی که شکست بخورد یا مهلتش تمام شود به همین شیوه دوباره امتحان می‌شود.

ارسالی که دوباره امتحان می‌شود هر بار همان کلید یکتایی را دارد، پس API به‌جای فرستادن پیام دوم، پیام نخست را بازپخش می‌کند.