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

try {    client.templates().send("order-shipped", Body.of(        "from", "[email protected]",        "to", "[email protected]",        "props", Body.of("orderId", "AC-4192")    ));} catch (ValidationException error) {    System.err.println(error.param() + " " + error.getMessage());} catch (RateLimitException error) {    System.err.println("Wait " + error.retryAfterSeconds() + " seconds");} catch (ApiException error) {    System.err.println(error.status() + " " + error.code() + " " + error.requestId());} catch (NetworkException error) {    System.err.println(error.isTimeout() ? "Timed out" : "No response");}

رد شدن از سوی API یک ApiException یا زیرکلاسِ نوع آن را پرتاب می‌کند، همراه با آنچه API درباره‌اش گفته است. هر استثنایی که کلاینت پرتاب می‌کند یک OpenEmailException بررسی‌نشده است، پس یک catch همه را پوشش می‌دهد.

یک ApiException به پرسش‌هایی دربارهٔ خودش هم پاسخ می‌دهد: isValidation()، isNotFound()، isRateLimited()، isServerError() و isRetryable()، به‌همراه isScopeMissing() وقتی اعتبارنامه دامنهٔ دسترسی لازم برای فراخوانی را ندارد و isStepUpRequired() وقتی یک توکن دسترسی باید نخست یک کد را تأیید کند. NetworkException.isTimeout() می‌گوید مهلت گذشته است.

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