Enum QrzXmlError 

pub enum QrzXmlError {
    Network(Error),
    XmlParsing(DeError),
    UrlParsing(ParseError),
    ApiError {
        message: String,
    },
    AuthenticationFailed {
        reason: String,
    },
    SessionExpired,
    CallsignNotFound {
        callsign: String,
    },
    DxccNotFound {
        entity: String,
    },
    InvalidInput {
        message: String,
    },
    ConnectionRefused,
    SubscriptionRequired,
    RateLimitExceeded,
    NoSessionKey,
    InvalidApiVersion {
        version: String,
    },
    UnexpectedResponse {
        message: String,
    },
}

Comprehensive error type for all QRZ API operations

Variants

Network(Error)

Network or HTTP-related errors

XmlParsing(DeError)

XML parsing errors

UrlParsing(ParseError)

URL parsing errors

ApiError

QRZ API returned an error message

Fields

message: String

AuthenticationFailed

Authentication failed

Fields

reason: String

SessionExpired

Session expired or invalid

CallsignNotFound

Callsign not found

Fields

callsign: String

DxccNotFound

DXCC entity not found

Fields

entity: String

InvalidInput

Invalid input provided

Fields

message: String

ConnectionRefused

QRZ service is refusing connections

SubscriptionRequired

Subscription required for this operation

RateLimitExceeded

Rate limit exceeded

NoSessionKey

No session key present in response

InvalidApiVersion

Invalid API version specified

Fields

version: String

UnexpectedResponse

Generic API error for unexpected responses

Fields

message: String

Implementations

impl QrzXmlError

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

Create a new API error

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

Create a new authentication error

pub fn callsign_not_found(callsign: impl Into<String>) -> Self

Create a new callsign not found error

pub fn dxcc_not_found(entity: impl Into<String>) -> Self

Create a new DXCC not found error

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

Create a new invalid input error

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

Create a new unexpected response error

pub fn should_reauthenticate(&self) -> bool

Check if this error indicates we should retry with authentication

pub fn is_retryable(&self) -> bool

Check if this error is retryable (temporary)

pub fn is_permission_error(&self) -> bool

Check if this error is due to insufficient permissions/subscription

Trait Implementations

impl Debug for QrzXmlError

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

Formats the value using the given formatter.

impl Display for QrzXmlError

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

Formats the value using the given formatter.

impl Error for QrzXmlError

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<DeError> for QrzXmlError

fn from(source: DeError) -> Self

Converts to this type from the input type.

impl From<Error> for QrzXmlError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for QrzXmlError

fn from(source: ParseError) -> Self

Converts to this type from the input type.