Enum Error 

#[non_exhaustive]
pub enum Error {
    Config(String),
    InvalidRequest(String),
    MissingAnswer {
        id: String,
        expected: &'static str,
    },
    BadRequest {
        message: String,
    },
    Authentication {
        message: String,
    },
    PermissionDenied {
        message: String,
    },
    NotFound {
        message: String,
    },
    UnprocessableEntity {
        message: String,
    },
    RateLimit {
        retry_after: Option<Duration>,
        message: String,
    },
    Overloaded {
        retry_after: Option<Duration>,
        message: String,
    },
    Server {
        status: u16,
        message: String,
    },
    UnexpectedStatus {
        status: u16,
        message: String,
    },
    Connection(Error),
    Timeout(Error),
    ResponseValidation(Error),
    RequestSerialization(Error),
}

Errors returned by Client.

HTTP-status variants carry the response body (truncated) as message.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Config(String)

Missing API key or otherwise unusable client configuration.

InvalidRequest(String)

The request was not sendable as built (no state, no questions, bad option set).

MissingAnswer

The response has no answer of the expected type under this id.

Fields

id: String

The question id that was looked up.

expected: &'static str

The answer type that was expected: noul, choice or score.

BadRequest

Fields

message: String

Response body, truncated.

Authentication

401: missing or invalid API key.

Fields

message: String

Response body, truncated.

PermissionDenied

Fields

message: String

Response body, truncated.

NotFound

Fields

message: String

Response body, truncated.

UnprocessableEntity

422: the request body failed validation.

Fields

message: String

Response body, truncated; names the offending field.

RateLimit

429: rate limit exceeded after all retries.

Fields

retry_after: Option<Duration>

The server’s retry-after, when it sent one.

message: String

Response body, truncated.

Overloaded

529: TypeSafe is temporarily overloaded, after all retries.

Fields

retry_after: Option<Duration>

The server’s retry-after, when it sent one.

message: String

Response body, truncated.

Server

Any other 5xx, after all retries.

Fields

status: u16

HTTP status code.

message: String

Response body, truncated.

UnexpectedStatus

Any other unexpected status.

Fields

status: u16

HTTP status code.

message: String

Response body, truncated.

Connection(Error)

The request never produced a response (DNS, connect, TLS, reset).

Timeout(Error)

The request exceeded its timeout.

ResponseValidation(Error)

The response body did not match the documented schema.

RequestSerialization(Error)

Failed to serialize the request body.

Implementations

impl Error

pub const fn status(&self) -> Option<u16>

The HTTP status behind this error, when there is one.

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, __formatter: &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.