Enum ApiError 

pub enum ApiError {
    Network(Error),
    Deserialize(Error),
    Http {
        status: StatusCode,
        message: String,
        details: Option<Value>,
    },
    Authentication(String),
    RateLimited {
        retry_after: Duration,
        body: String,
    },
    Cache(Error),
    Offline {
        resource: String,
    },
    UnclonableRequest,
    Other(String),
}

Errors that can occur while interacting with the Asana API.

Variants

Network(Error)

General networking failure.

Deserialize(Error)

Response payload could not be deserialised.

Http

HTTP status code returned an error.

Fields

status: StatusCode

HTTP status returned by Asana.

message: String

Message extracted from the response body or canonical reason.

details: Option<Value>

Optional structured payload returned alongside the error.

Authentication(String)

Authentication failed (401/403).

RateLimited

Rate limit was hit and retries exhausted.

Fields

retry_after: Duration

Recommended wait duration before retrying.

body: String

Raw response body returned with the 429.

Cache(Error)

Cache layer failure.

Offline

Offline mode requested data that was not cached.

Fields

resource: String

Resource identifier, typically the request path.

UnclonableRequest

Request could not be cloned for retry attempts.

Other(String)

Catch-all error message.

Implementations

impl ApiError

pub const fn http( status: StatusCode, message: String, details: Option<Value>, ) -> Self

Convenience constructor for HTTP errors with an optional JSON payload.

Trait Implementations

impl Debug for ApiError

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

Formats the value using the given formatter.

impl Display for ApiError

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

Formats the value using the given formatter.

impl Error for ApiError

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<ApiError> for Error

fn from(source: ApiError) -> Self

Converts to this type from the input type.

impl From<Error> for ApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ApiError

fn from(source: Error) -> Self

Converts to this type from the input type.