Enum QobuzApiError 

pub enum QobuzApiError {
    ApiErrorResponse {
        code: String,
        message: String,
        status: String,
    },
    ApiResponseParseError {
        content: String,
        source: Error,
    },
    QobuzApiInitializationError {
        message: String,
    },
    HttpError(Error),
    IoError(Error),
    LoftyError(LoftyError),
    UrlError(ParseError),
    AuthenticationError {
        message: String,
    },
    CredentialsError {
        message: String,
    },
    DownloadError {
        message: String,
    },
    MetadataError {
        source: Box<dyn Error + Send + Sync>,
    },
    ResourceNotFoundError {
        resource_type: String,
        resource_id: String,
    },
    RateLimitError {
        message: String,
    },
    InvalidParameterError {
        message: String,
    },
    UnexpectedApiResponseError {
        message: String,
    },
}

Custom error types for the Qobuz API Rust library.

This enum represents all possible errors that can occur when using the Qobuz API library. It includes errors from API responses, network operations, parsing, authentication, and more.

Examples

use qobuz_api_rust::QobuzApiError;

fn handle_error(error: QobuzApiError) {
    match error {
        QobuzApiError::ApiErrorResponse { code, message, status } => {
            eprintln!("API Error: {} - {} (Status: {})", code, message, status);
        }
        QobuzApiError::HttpError(e) => {
            eprintln!("HTTP Error: {}", e);
        }
        _ => eprintln!("Other error occurred: {:?}", error),
    }
}

Variants

ApiErrorResponse

Error response from the Qobuz API.

This variant represents an error response received from the Qobuz API itself, containing the error code, message, and status returned by the API.

Fields

• code - The error code returned by the API
• message - The error message provided by the API
• status - The status string returned by the API

Fields

code: String

The error code returned by the API

message: String

The error message provided by the API

status: String

The status string returned by the API

ApiResponseParseError

Error when parsing API response.

This variant represents an error that occurs when attempting to parse the response from the Qobuz API into a Rust data structure. It includes the original content that failed to parse and the underlying parsing error.

Fields

• content - The raw content that failed to parse
• source - The underlying parsing error from serde_json

Fields

content: String

The raw content that failed to parse

source: Error

The underlying parsing error from serde_json

QobuzApiInitializationError

Error during API initialization.

This variant represents an error that occurs during the initialization of the Qobuz API service, such as when failing to extract credentials from the web player or when required configuration is missing.

Fields

• message - A description of the initialization error

Fields

message: String

A description of the initialization error

HttpError(Error)

HTTP request error.

This variant wraps errors from the reqwest crate that occur during HTTP communication with the Qobuz API. This includes connection errors, timeout errors, and other network-related issues.

IoError(Error)

Network/IO error.

This variant wraps errors from the standard library’s std::io::Error that occur during network or file I/O operations, such as when downloading tracks or reading local files.

LoftyError(LoftyError)

Lofty library error.

This variant wraps errors from the lofty crate that occur during audio file metadata operations, such as reading, writing, or modifying tags. This includes errors when reading from or saving to audio files.

UrlError(ParseError)

URL parsing error.

This variant wraps errors from the url crate that occur when parsing or constructing URLs for API endpoints.

AuthenticationError

Authentication error.

This variant represents an error that occurs during authentication with the Qobuz API, such as invalid credentials or expired tokens.

Fields

• message - A description of the authentication error

Fields

message: String

A description of the authentication error

CredentialsError

Error when credentials are missing or invalid.

This variant represents an error that occurs when required credentials (app ID, app secret, user token, etc.) are missing, empty, or invalid.

Fields

message: String

A description of the credential issue

DownloadError

Error when downloading content.

This variant represents an error that occurs during content download operations, such as when downloading tracks, images, or other media files.

Fields

message: String

A description of the download issue

MetadataError

Error when processing metadata.

This variant represents an error that occurs during metadata extraction, embedding, or processing operations.

Fields

source: Box<dyn Error + Send + Sync>

The underlying error from metadata operations

ResourceNotFoundError

Error when a required resource is not found.

This variant represents an error that occurs when a requested resource (track, album, artist, etc.) is not found in the Qobuz API.

Fields

resource_type: String

The type of resource that was not found

resource_id: String

The ID of the resource that was not found

RateLimitError

Error when a rate limit is exceeded.

This variant represents an error that occurs when the Qobuz API rate limit is exceeded, typically resulting in a 429 HTTP status code.

Fields

message: String

A description of the rate limit issue

InvalidParameterError

Error when an invalid parameter is provided to an API call.

This variant represents an error that occurs when invalid or unsupported parameters are passed to an API endpoint.

Fields

message: String

A description of the invalid parameter

UnexpectedApiResponseError

Error when the API returns an unexpected response format.

This variant represents an error that occurs when the API returns a response that doesn’t match the expected format, indicating a potential API change or bug.

Fields

message: String

A description of the unexpected response

Trait Implementations

impl Debug for QobuzApiError

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

Formats the value using the given formatter.

impl Display for QobuzApiError

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

Formats the value using the given formatter.

impl Error for QobuzApiError

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 QobuzApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for QobuzApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<LoftyError> for QobuzApiError

fn from(source: LoftyError) -> Self

Converts to this type from the input type.

impl From<ParseError> for QobuzApiError

fn from(source: ParseError) -> Self

Converts to this type from the input type.