Enum Error 

pub enum Error {
    InvalidProject {
        message: String,
    },
    InvalidApiKey {
        message: String,
    },
    InvalidAmount {
        message: String,
    },
    InvalidOrderId {
        message: String,
    },
    InvalidPaymentMethod {
        message: String,
    },
    EncodeJson {
        message: String,
        source: Error,
    },
    DecodeJson {
        message: String,
        source: Error,
    },
    BuildRequest {
        source: ParseError,
    },
    Api {
        status: StatusCode,
        body: String,
    },
    RequestFailed {
        message: String,
        source: BoxError,
    },
    RequestFailedAfterRetries {
        message: String,
        source: BoxError,
    },
    ResponseTooLarge {
        limit: usize,
    },
}

Every error the SDK can produce.

Variants

InvalidProject

The project slug is empty. Triggered by crate::Client::do_request before any network call.

Fields

message: String

InvalidApiKey

The API key is empty. Triggered by crate::Client::do_request before any network call.

Fields

message: String

InvalidAmount

amount was zero or negative.

Fields

message: String

InvalidOrderId

order_id was empty.

Fields

message: String

InvalidPaymentMethod

A payment method outside the supported set was used. Currently unused because the typed crate::PaymentMethod enum makes invalid values unrepresentable, but kept here so future runtime checks have a slot to land in.

Fields

message: String

EncodeJson

serde_json refused to encode the request body.

Fields

message: String

source: Error

DecodeJson

serde_json refused to decode the response body.

Fields

message: String

source: Error

BuildRequest

The configured base URL combined with a path did not parse as a URL.

Fields

source: ParseError

Api

The API returned a non-2xx response.

body is the raw response body decoded as UTF-8 with lossy substitution. Use Error::api_status to read the status code programmatically.

Fields

status: StatusCode

body: String

RequestFailed

A request hit a permanent transport-level failure (TLS, invalid URL after the builder accepted it, response too large, …).

Fields

message: String

source: BoxError

RequestFailedAfterRetries

The retry loop ran out of attempts. source is the last transient failure observed.

Fields

message: String

source: BoxError

ResponseTooLarge

The response body exceeded the configured size cap. Returned without fully buffering the offending response.

Fields

limit: usize

Implementations

impl Error

pub fn api_status(&self) -> Option<StatusCode>

Return the HTTP status when this is an Error::Api, otherwise None. Handy for branch logic without having to match on the full enum.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.