Crate reqwest_retry

Middleware to retry failed HTTP requests built on reqwest_middleware.

Use RetryTransientMiddleware to retry failed HTTP requests. Retry control flow is managed by a RetryPolicy.

Example

use reqwest_middleware::{ClientBuilder, ClientWithMiddleware};
use reqwest_retry::{RetryTransientMiddleware, policies::ExponentialBackoff};

async fn run_retries() {
    // Retry up to 3 times with increasing intervals between attempts.
    let retry_policy = ExponentialBackoff::builder().build_with_max_retries(3);
    let client = ClientBuilder::new(reqwest::Client::new())
        .with(RetryTransientMiddleware::new_with_policy(retry_policy))
        .build();

    client
        .get("https://truelayer.com")
        .header("foo", "bar")
        .send()
        .await
        .unwrap();
}

Modules

• policies

Structs

• DefaultRetryableStrategy
  The default RetryableStrategy for RetryTransientMiddleware.
• RetryTransientMiddleware
  RetryTransientMiddleware offers retry logic for requests that fail in a transient manner and can be safely executed again.

Enums

• Jitter
  How to apply jitter to the retry intervals.
• RetryDecision
  Outcome of evaluating a retry policy for a failed task.
• RetryError
  Custom error type to attach the number of retries to the error message.
• Retryable
  Classification of an error/status returned by request.

Traits

• RetryPolicy
  A policy for deciding whether and when to retry.
• RetryableStrategy
  A strategy to create a Retryable from a Result<reqwest::Response, reqwest_middleware::Error>

Functions

• default_on_request_failure
  Default request failure retry strategy.
• default_on_request_success
  Default request success retry strategy.