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.