Struct HttpClientConfig 

pub struct HttpClientConfig {
    pub timeout_secs: u64,
    pub max_retries: u32,
    pub max_retry_after_secs: u64,
    pub max_backoff_ms: u64,
    pub base_urls: HashMap<String, String>,
    pub send_deadline_header: bool,
    pub retry_budget: RetryBudgetConfig,
    pub adaptive_throttle: AdaptiveThrottleConfig,
}

Configuration for the outbound HTTP client ([http.client] in autumn.toml).

Example autumn.toml

[http.client]
timeout_secs = 30
max_retries  = 3

[http.client.base_urls]
stripe   = "https://api.stripe.com"
sendgrid = "https://api.sendgrid.com"

Fields

timeout_secs: u64

Per-request timeout in seconds. Default: 30.

max_retries: u32

Maximum retry attempts for transient failures on idempotent methods. Default: 3 (four total attempts).

max_retry_after_secs: u64

Cap on a Retry-After hint, in seconds. Default: 10. The wait is also at most the backoff plus 5 s (issue #3054), so a value above 5 has no effect.

max_backoff_ms: u64

Cap on the jittered retry backoff in milliseconds. Default: 20 000. See crate::backoff.

base_urls: HashMap<String, String>

Named base URL aliases, e.g. stripe = "https://api.stripe.com".

A Client configured with .named("stripe") will prepend this URL to relative request paths and match against mocks registered for that alias via TestApp::http_mock.

send_deadline_header: bool

Send the time left of the request deadline downstream in the x-autumn-deadline-ms header. The client sends it only when a deadline is set. Default: true.

retry_budget: RetryBudgetConfig

Retry budget ([http.client.retry_budget]). See RetryBudgetConfig.

adaptive_throttle: AdaptiveThrottleConfig

Client-side adaptive throttling per host (issue #3068). Off by default. See AdaptiveThrottleConfig.

Trait Implementations

impl Clone for HttpClientConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpClientConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HttpClientConfig

Available on crate feature http-client only.

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HttpClientConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.