Enum Error 

pub enum Error {
    Config(String),
    Url(ParseError),
    Http(Error),
    Json(Error),
    Api {
        status: u16,
        error: Box<ApiError>,
    },
    Exception {
        status: u16,
        exception: Box<ApiException>,
    },
    Unexpected {
        status: u16,
        body: String,
    },
}

All errors the SDK can produce.

See the error module docs for the dispatch logic between Error::Api and Error::Exception.

Variants

Config(String)

Returned when Client::builder is missing required state, or when an option is malformed (e.g. an auth value that can’t be put in an HTTP header).

Url(ParseError)

The configured base URL or a derived endpoint URL failed to parse.

Http(Error)

A network or HTTP-level failure: connection refused, timeout, TLS error, mid-stream disconnect, etc.

Json(Error)

The response body couldn’t be (de)serialized as JSON.

You shouldn’t see this for normal operation — open an issue if you do, since it usually means the API has drifted from the version of the spec this crate was built against.

Api

Structured error returned by the v3 endpoints.

Endpoints that surface this variant: /sms/3/messages, /sms/3/reports, /sms/3/logs.

Fields

status: u16

HTTP status code (e.g. 400, 401, 403, 500).

error: Box<ApiError>

Server-provided structured error.

Exception

Legacy ApiException returned by the v1 endpoints.

Endpoints that surface this variant: /sms/1/preview, /sms/1/bulks (and .../status), /sms/1/inbox/reports, /ct/1/log/end/{messageId}.

Fields

status: u16

HTTP status code.

exception: Box<ApiException>

Server-provided exception payload.

Unexpected

The server returned a non-2xx response whose body matched neither error schema. The raw body is preserved verbatim.

Fields

status: u16

HTTP status code.

body: String

Raw response body, decoded as UTF-8 (lossily if needed).

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.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(source: ParseError) -> Self

Converts to this type from the input type.