Enum ReroutError 

pub enum ReroutError {
    Api {
        code: String,
        status: u16,
        message: String,
        extra: Box<ApiErrorDetails>,
    },
    Network {
        message: String,
    },
    Timeout {
        message: String,
    },
    Unexpected {
        status: u16,
        message: String,
    },
    Decode {
        message: String,
    },
    Config {
        code: String,
        message: String,
    },
}

Every error surfaced by the SDK.

Match on the variant for branching logic, and read ReroutError::code for the stable string identifier (e.g. bad_target_url, rate_limited).

Variants

Api

The server replied with a non-2xx status.

code is the stable identifier — preferring the API’s code when one was provided in the JSON body, falling back to a synthetic status-derived code otherwise.

Fields

code: String

Stable error identifier (e.g. bad_target_url, rate_limited).

status: u16

HTTP status code returned by the server.

message: String

Human-readable error message.

extra: Box<ApiErrorDetails>

Extra fields (path, timestamp, details) when supplied.

Boxed to keep the ReroutError enum compact — the optional diagnostics rarely matter on the hot path.

Network

The request never reached the server (DNS, TLS, connection reset, …).

Fields

message: String

Reason from the transport layer.

Timeout

The request was aborted after exceeding the client timeout.

Fields

message: String

Reason from the transport layer.

Unexpected

The server returned 2xx but the body could not be decoded as JSON.

Fields

status: u16

HTTP status code (always 2xx here).

message: String

Reason this body could not be interpreted.

Decode

A JSON body failed to decode against the expected schema.

Fields

message: String

Reason this body could not be deserialized.

Config

The client was misconfigured (missing API key, invalid base URL, …).

code mirrors the synthetic codes the API would otherwise use (e.g. missing_api_key, invalid_base_url).

Fields

code: String

Stable synthetic code for the configuration failure.

message: String

Human-readable explanation.

Implementations

impl ReroutError

pub fn code(&self) -> &str

The stable string error code — either from the API or a synthetic one.

Use this for branching logic (if err.code() == "rate_limited" { ... }) rather than parsing the message.

pub fn status(&self) -> u16

HTTP status code, or 0 when no response reached the client.

pub fn message(&self) -> String

Human-readable message — equivalent to format!("{err}").

pub fn is_rate_limited(&self) -> bool

true when this is an HTTP 429 (rate_limited) response.

Caller should back off and retry with jitter.

pub fn is_server_error(&self) -> bool

true when this is an HTTP 5xx response — a server-side issue.

pub fn path(&self) -> Option<&str>

path from the API error envelope, when supplied.

pub fn timestamp(&self) -> Option<&str>

timestamp from the API error envelope, when supplied.

pub fn details(&self) -> Option<&Value>

Optional details field from the API error envelope.

Trait Implementations

impl Debug for ReroutError

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

Formats the value using the given formatter.

impl Display for ReroutError

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

Formats the value using the given formatter.

impl Error for ReroutError

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.