Enum AmberError 

#[non_exhaustive]
pub enum AmberError {
    Http(Error),
    RateLimitExceeded(u64),
    RateLimitExhausted {
        attempts: u32,
        retry_after: u64,
    },
    UnexpectedStatus {
        status: u16,
        body: String,
    },
}

Error types that can occur when using the Amber 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.

Http(Error)

HTTP request error.

RateLimitExceeded(u64)

Rate limit exceeded. Contains the number of seconds to wait.

This error is returned when the API rate limit is hit and automatic retries are disabled via retry_on_rate_limit(false).

RateLimitExhausted

Rate limit exceeded and max retries exhausted.

This error is returned when the API rate limit is hit and the maximum number of retry attempts has been exhausted. The attempts field shows how many retries were attempted, and retry_after shows the suggested wait time in seconds before trying again.

Fields

attempts: u32

Number of retry attempts that were made.

retry_after: u64

Number of seconds to wait before retrying.

UnexpectedStatus

Unexpected HTTP status code.

This error is returned when the API returns a non-2xx status code that is not specifically handled (e.g., not a rate limit error).

Fields

status: u16

HTTP status code.

body: String

Response body (may be truncated or empty if unreadable).

Trait Implementations

impl Debug for AmberError

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

Formats the value using the given formatter.

impl Display for AmberError

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

Formats the value using the given formatter.

impl Error for AmberError

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 AmberError

fn from(source: Error) -> Self

Converts to this type from the input type.