Enum ProviderError 

pub enum ProviderError {
    ApiError {
        status: u16,
        message: String,
    },
    RateLimitExceeded {
        provider_id: String,
    },
    NetworkError(String),
    InvalidData(String),
    NotFound(String),
    AuthenticationFailed(String),
    ProviderUnavailable(String),
    SerializationError(String),
    InvalidConfiguration(String),
    Timeout {
        timeout_ms: u64,
    },
    Other(String),
}

Errors that can occur during provider operations

These errors cover common failure modes across all provider types, including network errors, API errors, authentication failures, and rate limiting.

Variants

ApiError

Provider API returned an error response

Fields

status: u16

HTTP status code

message: String

Error message from provider

RateLimitExceeded

Rate limit exceeded for this provider

Fields

provider_id: String

Provider identifier

NetworkError(String)

Network error occurred during communication with provider

InvalidData(String)

Invalid or malformed data received from provider

NotFound(String)

Requested resource not found

AuthenticationFailed(String)

Authentication or authorization failed

ProviderUnavailable(String)

Provider is temporarily unavailable

SerializationError(String)

Serialization/deserialization error

InvalidConfiguration(String)

Invalid configuration

Timeout

Operation timeout

Fields

timeout_ms: u64

Timeout duration in milliseconds

Other(String)

General error with custom message

Implementations

impl ProviderError

pub fn api_error(status: u16, message: impl Into<String>) -> Self

Create an API error

pub fn rate_limit(provider_id: impl Into<String>) -> Self

Create a rate limit error

pub fn network(message: impl Into<String>) -> Self

Create a network error

pub fn invalid_data(message: impl Into<String>) -> Self

Create an invalid data error

pub fn not_found(resource: impl Into<String>) -> Self

Create a not found error

pub fn auth_failed(message: impl Into<String>) -> Self

Create an authentication error

pub fn unavailable(message: impl Into<String>) -> Self

Create a provider unavailable error

pub fn timeout(timeout_ms: u64) -> Self

Create a timeout error

pub fn is_retriable(&self) -> bool

Check if this is a retriable error

Returns true for errors that may succeed on retry (network errors, timeouts, provider unavailable), and false for permanent errors (authentication, not found).

pub fn is_auth_error(&self) -> bool

Check if this is an authentication error

pub fn is_rate_limit(&self) -> bool

Check if this is a rate limit error

Trait Implementations

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

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 ProviderError

Available on crate feature reqwest only.

fn from(err: Error) -> Self

Converts to this type from the input type.