Enum Error 

pub enum Error {
    Authentication {
        code: u16,
        message: String,
        error_type: String,
        details: String,
        is_transient: bool,
        http_status_code: u16,
        error_subcode: u16,
    },
    RateLimit {
        code: u16,
        message: String,
        error_type: String,
        details: String,
        retry_after: Duration,
        is_transient: bool,
        http_status_code: u16,
        error_subcode: u16,
    },
    Validation {
        code: u16,
        message: String,
        error_type: String,
        details: String,
        field: String,
        is_transient: bool,
        http_status_code: u16,
        error_subcode: u16,
    },
    Network {
        code: u16,
        message: String,
        error_type: String,
        details: String,
        temporary: bool,
        is_transient: bool,
        http_status_code: u16,
        error_subcode: u16,
        cause: Option<Error>,
    },
    Api {
        code: u16,
        message: String,
        error_type: String,
        details: String,
        request_id: String,
        is_transient: bool,
        http_status_code: u16,
        error_subcode: u16,
    },
    Http(Error),
    Json(Error),
}

All error variants returned by the Threads API client.

Variants

Authentication

An authentication or authorization failure (e.g. invalid/expired token).

Fields

code: u16

API error code.

message: String

Human-readable error message.

error_type: String

Machine-readable error category.

details: String

Additional detail string from the API.

is_transient: bool

Whether the API flagged this error as transient.

http_status_code: u16

HTTP status code of the response.

error_subcode: u16

API error sub-code for finer classification.

RateLimit

The request was throttled by the API rate limiter.

Fields

code: u16

API error code.

message: String

Human-readable error message.

error_type: String

Machine-readable error category.

details: String

Additional detail string from the API.

retry_after: Duration

Suggested wait time before retrying.

is_transient: bool

Whether the API flagged this error as transient.

http_status_code: u16

HTTP status code of the response.

error_subcode: u16

API error sub-code for finer classification.

Validation

A request parameter or payload failed validation.

Fields

code: u16

API error code.

message: String

Human-readable error message.

error_type: String

Machine-readable error category.

details: String

Additional detail string from the API.

field: String

Name of the invalid field.

is_transient: bool

Whether the API flagged this error as transient.

http_status_code: u16

HTTP status code of the response.

error_subcode: u16

API error sub-code for finer classification.

Network

A transport-level failure (DNS, TCP, TLS, timeout, etc.).

Fields

code: u16

API error code.

message: String

Human-readable error message.

error_type: String

Machine-readable error category.

details: String

Additional detail string from the API.

temporary: bool

Whether the failure appears to be temporary.

is_transient: bool

Whether the API flagged this error as transient.

http_status_code: u16

HTTP status code of the response.

error_subcode: u16

API error sub-code for finer classification.

cause: Option<Error>

Optional underlying reqwest error.

Api

A generic API error that does not fit a more specific variant.

Fields

code: u16

API error code.

message: String

Human-readable error message.

error_type: String

Machine-readable error category.

details: String

Additional detail string from the API.

request_id: String

Server-assigned request identifier for support/debugging.

is_transient: bool

Whether the API flagged this error as transient.

http_status_code: u16

HTTP status code of the response.

error_subcode: u16

API error sub-code for finer classification.

Http(Error)

An HTTP-level error from the underlying reqwest client.

Json(Error)

A JSON serialization or deserialization error.

Implementations

impl Error

pub fn is_authentication(&self) -> bool

Returns true if this is an authentication error.

pub fn is_rate_limit(&self) -> bool

Returns true if this is a rate-limit error.

pub fn is_validation(&self) -> bool

Returns true if this is a validation error.

pub fn is_network(&self) -> bool

Returns true if this is a network error.

pub fn is_api(&self) -> bool

Returns true if this is a generic API error.

pub fn is_transient(&self) -> bool

Returns true if the API flagged this error as transient.

pub fn is_retryable(&self) -> bool

Returns true if the request can be retried (rate-limit, transient, or temporary network).

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.