Enum Error 

#[non_exhaustive]
pub enum Error {
    MissingApiKey,
    BadRequest {
        endpoint: String,
        body: String,
    },
    Unauthorized {
        endpoint: String,
    },
    Forbidden {
        endpoint: String,
    },
    NotFound {
        endpoint: String,
    },
    RateLimited {
        endpoint: String,
        retry_after: Option<Duration>,
    },
    InternalServerError {
        endpoint: String,
        body: String,
    },
    UnexpectedStatusCode {
        endpoint: String,
        status: u16,
        body: String,
    },
    Http(Error),
    Io(Error),
}

Errors returned by the Datamaxi+ API client.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

MissingApiKey

No API key was provided explicitly and DATAMAXI_API_KEY is unset or empty.

BadRequest

The API returned a 400 Bad Request; the payload carries the server message.

endpoint is the request path that failed (e.g. /api/v1/liquidation/heatmap), so failures are diagnosable without enabling tracing.

Fields

endpoint: String

The request path that produced this error.

body: String

The server message (capped, possibly empty).

Unauthorized

The API returned a 401 Unauthorized (missing or invalid API key).

Fields

endpoint: String

The request path that produced this error.

Forbidden

The API returned a 403 Forbidden (the key is valid but lacks access to the resource).

Fields

endpoint: String

The request path that produced this error.

NotFound

The API returned a 404 Not Found (the resource or endpoint does not exist).

endpoint names which of the endpoints 404’d, so the error is actionable on its own.

Fields

endpoint: String

The request path that produced this error.

RateLimited

The API returned a 429 Too Many Requests (rate limited).

retry_after carries the Retry-After header when present, parsed from either the delay-seconds or the HTTP-date form (a past date clamps to zero). This is the server’s actual suggestion and is not clamped to [RETRY_MAX_DELAY] (that cap only bounds the client’s internal retry sleeps).

Fields

endpoint: String

The request path that produced this error.

retry_after: Option<Duration>

Suggested wait before retrying, from the Retry-After header (raw, uncapped).

InternalServerError

The API returned a 500 Internal Server Error; the payload carries the server message.

Fields

endpoint: String

The request path that produced this error.

body: String

The server message (capped, possibly empty).

UnexpectedStatusCode

The API returned a status code the client does not specifically handle.

Carries the request endpoint, the raw status code, and the (capped) response body. An unexpected status is exactly the case where the body is most useful for diagnosis, so — like Error::BadRequest / Error::InternalServerError — it is preserved rather than discarded. The body is truncated to a capped length on a UTF-8 char boundary.

Fields

endpoint: String

The request path that produced this error.

status: u16

The raw HTTP status code.

body: String

The response body (capped, possibly empty).

Http(Error)

The underlying HTTP request failed, or the response body could not be decoded. The failing URL is available via reqwest::Error::url on the wrapped error.

Io(Error)

Reading the response body failed.

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.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.