Enum Error 

pub enum Error {
    Authentication {
        status: u16,
        message: String,
        body: String,
    },
    RateLimit {
        status: u16,
        message: String,
        body: String,
        limit: Option<i64>,
        remaining: Option<i64>,
        reset: Option<i64>,
    },
    InvalidRequest {
        status: u16,
        message: String,
        body: String,
    },
    Server {
        status: u16,
        message: String,
        body: String,
    },
    Api {
        status: u16,
        message: String,
        body: String,
    },
    Transport(Error),
    InvalidArgument(String),
}

Errors returned by the ip-api.io client.

The client never retries; Error::RateLimit’s reset field is the unix timestamp when the quota renews.

Variants

Authentication

HTTP 401/403 — missing or invalid API key.

Fields

status: u16

message: String

body: String

RateLimit

HTTP 429 — quota exhausted, with the x-ratelimit-* header values.

Fields

status: u16

message: String

body: String

limit: Option<i64>

remaining: Option<i64>

reset: Option<i64>

InvalidRequest

HTTP 400/404/422 — malformed input or unknown resource.

Fields

status: u16

message: String

body: String

Server

HTTP 5xx — ip-api.io server-side failure.

Fields

status: u16

message: String

body: String

Api

Any other non-2xx response.

Fields

status: u16

message: String

body: String

Transport(Error)

Transport-level failure (DNS, connect, timeout, TLS, JSON decoding).

InvalidArgument(String)

Invalid argument detected before any network call (e.g. oversized batch).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(inner: Error) -> Self

Converts to this type from the input type.