Struct HttpClient 

pub struct HttpClient { /* private fields */ }

HTTP client, see the module documentation. Cloning shares the connection pool.

Implementations

impl HttpClient

pub fn new() -> Self

pub fn timeout(self, timeout: Duration) -> Self

Longest a single attempt (connect, send, read the whole response) may take (default 30 s)

pub fn connect_timeout(self, timeout: Duration) -> Self

Longest name resolution + TCP/TLS connect may take (default 10 s)

pub fn max_response_bytes(self, max: usize) -> Self

Largest response body accepted (default 10 MiB)

pub fn max_redirects(self, max: usize) -> Self

Redirects followed per call (default 5, 0 returns the 3xx response itself)

pub fn retries(self, retries: u32) -> Self

Extra attempts after a failure that is safe to repeat (default 0)

pub fn retry_backoff(self, base: Duration) -> Self

First retry delay, doubled each time with jitter (default 200 ms)

pub fn public_only(self) -> Self

Only connect to public addresses: loopback, private, link-local and cloud-metadata targets are refused with ClientError::Blocked. Use it whenever the URL comes from a user (webhooks, link previews, imports).

pub fn user_agent(self, agent: &str) -> Self

pub fn default_header(self, name: &str, value: &str) -> Self

Header sent with every request (unless the request sets it itself)

pub fn pool_idle_timeout(self, timeout: Duration) -> Self

Keep idle connections this long for reuse (default 30 s, zero disables pooling)

pub fn add_root_certificates_pem(self, pem: &[u8]) -> Result<Self, ClientError>

Trust these PEM root certificates in addition to the built-in ones, e.g. a private CA (feature client-tls)

pub fn request(&self, method: Method, url: &str) -> RequestBuilder

pub fn get(&self, url: &str) -> RequestBuilder

pub fn post(&self, url: &str) -> RequestBuilder

pub fn put(&self, url: &str) -> RequestBuilder

pub fn patch(&self, url: &str) -> RequestBuilder

pub fn delete(&self, url: &str) -> RequestBuilder

pub fn head(&self, url: &str) -> RequestBuilder

Trait Implementations

impl Clone for HttpClient

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for HttpClient

fn default() -> Self

Returns the “default value” for a type.