Enum Error 

pub enum Error {
    Transport(Error),
    Decode(Error),
    Api(ApiError),
    Unexpected {
        status: u16,
        body: String,
    },
}

Everything that can go wrong when calling the Messages API.

Variants

Transport(Error)

The HTTP request never produced a usable response: a connection failure, a timeout, or a request that could not be built or sent. Treated as retryable, since these are usually transient.

Decode(Error)

A 2xx response arrived but its body did not deserialize into the expected shape. Not retried: the same body would fail again.

Api(ApiError)

The API returned a non-2xx response with a well-formed error envelope. Retryable only for 429, 500, and 529.

Unexpected

A non-2xx response whose body was not a recognizable error envelope. The raw body is preserved so the caller can see what the server actually sent. Not retried.

Fields

status: u16

The HTTP status code of the response.

body: String

The raw response body, decoded lossily as UTF-8.

Implementations

impl Error

pub fn is_retryable(&self) -> bool

Whether trying the request again could plausibly succeed.

Transport failures are always worth a retry. API errors are retried for the three statuses the protocol calls out as transient: 429 (rate limited), 500 (server error), and 529 (overloaded). Decode failures and other non-2xx responses are permanent for this request.

pub fn retry_after(&self) -> Option<Duration>

The server-requested wait before retrying, when the response carried a retry-after header. The retry loop honours this in preference to its own backoff schedule.

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.