Enum RdapError 

pub enum RdapError {
    InvalidInput(String),
    SsrfBlocked {
        url: String,
        reason: String,
    },
    InsecureScheme {
        scheme: String,
    },
    NoServerFound {
        query: String,
    },
    BootstrapFetch {
        resource: String,
        source: Box<RdapError>,
    },
    Network(Error),
    HttpStatus {
        status: u16,
        url: String,
    },
    Timeout {
        millis: u64,
        url: String,
    },
    ParseError {
        reason: String,
    },
    MissingObjectClass,
    UnknownObjectClass {
        class: String,
    },
    Cache(String),
    InvalidUrl {
        url: String,
        source: ParseError,
    },
}

The unified error type for all rdapify operations.

Examples

use rdap_types::RdapError;

fn handle(err: RdapError) {
    match err {
        RdapError::InvalidInput(msg) => eprintln!("Bad input: {msg}"),
        RdapError::NoServerFound { query } => eprintln!("No RDAP server for: {query}"),
        RdapError::Network(e) => eprintln!("Network error: {e}"),
        _ => {}
    }
}

Variants

InvalidInput(String)

The supplied domain name, IP address, or ASN is not valid.

SsrfBlocked

The resolved URL targets a private, loopback, or link-local address.

Fields

url: String

reason: String

InsecureScheme

The URL scheme is not HTTPS.

Fields

scheme: String

NoServerFound

No RDAP server was found for the given TLD / IP range / ASN range.

Fields

query: String

BootstrapFetch

The IANA bootstrap file could not be fetched or parsed.

Fields

resource: String

source: Box<RdapError>

Network(Error)

A network-level error occurred (DNS, TCP, TLS, timeout).

HttpStatus

The RDAP server returned an HTTP error status.

Fields

status: u16

url: String

Timeout

The request did not complete within the configured timeout.

Fields

millis: u64

url: String

ParseError

The response JSON could not be deserialized into a known RDAP type.

Fields

reason: String

MissingObjectClass

The response is missing a required objectClassName field.

UnknownObjectClass

The response contains an objectClassName that this client does not recognise.

Fields

class: String

Cache(String)

An internal cache operation failed (should be rare).

InvalidUrl

A URL could not be parsed.

Fields

url: String

source: ParseError

Implementations

impl RdapError

pub fn status_code(&self) -> u16

Returns an HTTP-like status code for the error, suitable for surfacing through FFI or REST bindings.

pub fn is_invalid_input(&self) -> bool

Returns true if the error is caused by invalid user input.

pub fn is_network(&self) -> bool

Returns true if the error is a network-level failure.

pub fn is_ssrf_blocked(&self) -> bool

Returns true if the request was blocked by SSRF protection.

Trait Implementations

impl Debug for RdapError

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

Formats the value using the given formatter.

impl Display for RdapError

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

Formats the value using the given formatter.

impl Error for RdapError

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 RdapError

fn from(source: Error) -> Self

Converts to this type from the input type.