Enum EuroMailError 

pub enum EuroMailError {
    Authentication(String),
    Validation {
        code: String,
        message: String,
    },
    RateLimit {
        retry_after: Option<u64>,
        message: String,
    },
    NotFound(String),
    Api {
        status: u16,
        code: String,
        message: String,
    },
    Http(Error),
}

Errors returned by the EuroMail SDK.

All API methods return Result<T, EuroMailError>. HTTP-level errors from the EuroMail API are mapped to specific variants based on status code, while network and deserialization failures surface as EuroMailError::Http.

Example

let client = EuroMail::new("em_live_key");
match client.get_email("nonexistent").await {
    Err(EuroMailError::NotFound(msg)) => eprintln!("Not found: {msg}"),
    Err(EuroMailError::RateLimit { retry_after, .. }) => {
        eprintln!("Rate limited, retry after {retry_after:?}s");
    }
    Err(e) => eprintln!("Error: {e}"),
    Ok(detail) => println!("Email: {}", detail.email.id),
}

Variants

Authentication(String)

Invalid or expired API key (HTTP 401).

Validation

Request failed validation — e.g. missing required fields (HTTP 422).

Fields

code: String

message: String

RateLimit

Too many requests. retry_after contains the suggested wait in seconds if the server provided a Retry-After header (HTTP 429).

Fields

retry_after: Option<u64>

message: String

NotFound(String)

The requested resource does not exist (HTTP 404).

Api

Any other API error (HTTP 4xx/5xx).

Fields

status: u16

code: String

message: String

Http(Error)

Network or deserialization error from the underlying HTTP client.

Trait Implementations

impl Debug for EuroMailError

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

Formats the value using the given formatter.

impl Display for EuroMailError

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

Formats the value using the given formatter.

impl Error for EuroMailError

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 EuroMailError

fn from(source: Error) -> Self

Converts to this type from the input type.