Enum ClientError 

pub enum ClientError {
    Request(Error),
    Json(Error),
    NoMock(String, String),
    CircuitBreakerOpen,
    SsrfBlocked(String),
    TooManyRedirects(usize),
    RedirectRejected(String),
    InvalidUrl(String),
    IncompatiblePinRedirect(&'static str),
    PinRequiresDomainHost(&'static str),
    PinNotAllowedWithSsrfSafe(&'static str),
}

Errors produced by Client and RequestBuilder.

Variants

Request(Error)

An underlying reqwest transport error.

Json(Error)

JSON (de)serialisation failed.

NoMock(String, String)

No mock entry matched the outgoing request.

CircuitBreakerOpen

The outbound circuit breaker is open.

SsrfBlocked(String)

A resolved connection target (or redirect target) is a blocked (private / link-local / loopback / reserved) IP address per the built-in SSRF policy. See is_blocked_ip.

TooManyRedirects(usize)

A redirect chain exceeded the configured maximum number of hops.

RedirectRejected(String)

A redirect’s absolute Location target was rejected by the caller’s validator (or by the built-in scheme-downgrade guard).

InvalidUrl(String)

A URL could not be parsed, was missing a host, or DNS resolution failed while composing a custom (redirect / pin / SSRF-safe) request.

IncompatiblePinRedirect(&'static str)

pin_to was combined with follow_redirects — an incompatible pair. A single pinned SocketAddr only covers the first hop; later redirect hops re-resolve via normal DNS, so following a cross-host 3xx would silently escape the pin and defeat its purpose. Use Client::get_ssrf_safe for pinned, per-hop-revalidated redirect following; pin_to alone (returns the 3xx unfollowed); or follow_redirects without pin_to.

PinRequiresDomainHost(&'static str)

pin_to was used on a request whose URL host is an IP literal. reqwest/hyper treat an IP-literal host as already-resolved and never consult the DNS resolver, so the resolve_to_addrs override that installs the pin is skipped and the socket connects to the literal in the URL — not the pinned address — silently bypassing the pin. pin_to therefore requires a domain (hostname) host; put the desired IP directly in the URL, or use a domain host. (get_ssrf_safe never sets a pin: it validates the literal and connects to that same IP, so it is unaffected.)

PinNotAllowedWithSsrfSafe(&'static str)

pin_to was combined with Client::get_ssrf_safe — an incompatible pair. The SSRF-safe path runs its own per-hop resolve→validate→pin and never reads the caller’s pin_to address, so an explicit pin would be silently ignored. Use pin_to alone for a caller-chosen fixed address, or get_ssrf_safe alone for guarded automatic per-hop pinning — not both.

Trait Implementations

impl Debug for ClientError

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

Formats the value using the given formatter.

impl Display for ClientError

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

Formats the value using the given formatter.

impl Error for ClientError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ClientError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClientError

fn from(source: Error) -> Self

Converts to this type from the input type.