Enum Error

pub enum Error<E = NoError> {
    Api(E),
    HttpClient(Box<dyn Error + Send + Sync + 'static>),
    Json(Error),
    UnexpectedResponse(String),
    BadRequest(String),
    Authentication(AuthError),
    RateLimited {
        reason: RateLimitReason,
        retry_after_seconds: u32,
    },
    AccessDenied(AccessError),
    ServerError(String),
    UnexpectedHttpError {
        code: u16,
        response: String,
    },
}

An error occurred in the process of making an API call. This is different from the case where your call succeeded, but the operation returned an error.

Variants

Api(E)

An error returned by the API. Its type depends on the endpoint being called.

HttpClient(Box<dyn Error + Send + Sync + 'static>)

Some error from the internals of the HTTP client.

Json(Error)

Something went wrong in the process of transforming your arguments into a JSON string.

UnexpectedResponse(String)

The Dropbox API response was unexpected or malformed in some way.

BadRequest(String)

The Dropbox API indicated that your request was malformed in some way.

Authentication(AuthError)

Errors occurred during authentication.

RateLimited

Your request was rejected due to rate-limiting. You can retry it later.

Fields

reason: RateLimitReason

The server-given reason for the rate-limiting.

retry_after_seconds: u32

You can retry this request after this many seconds.

AccessDenied(AccessError)

The user or team account doesn’t have access to the endpoint or feature.

ServerError(String)

The Dropbox API server had an internal error.

UnexpectedHttpError

The Dropbox API returned an unexpected HTTP response code.

Fields

code: u16

HTTP status code returned.

response: String

The response body.

Implementations

impl<E: Error + 'static> Error<E>

pub fn downcast_ref_inner<E2: Error + 'static>(&self) -> Option<&E2>

Look for an inner error of the given type anywhere within this error, by walking the chain of std::error::Error::source recursively until something matches the desired type.

impl<E: Error + Send + Sync + 'static> Error<E>

pub fn boxed(self) -> BoxedError

Change the concretely-typed API error, if any, into a boxed trait object.

This makes it possible to combine dissimilar errors into one type, which can be broken out later using std::error::Error::downcast_ref if desired.

impl Error<NoError>

pub fn typed<E>(self) -> Error<E>

Lift an error with no possible API error value to a typed error of any type.

Ideally this would just be impl<E> From<Error<NoError>> for Error<E> but that conflicts with the reflexive conversion (E could be NoError), and Rust doesn’t have negative type bounds or specialization, so it has to be this method instead.

Trait Implementations

impl<E: Debug> Debug for Error<E>

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

Formats the value using the given formatter.

impl<E> Display for Error<E>

where E: Display,

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

Formats the value using the given formatter.

impl<E> Error for Error<E>

where E: Error + 'static, Self: Debug + Display,

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

Available on crate feature default_client only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl<E> From<Error> for Error<E>

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<RequestError> for Error

Available on crate feature default_client only.

fn from(e: RequestError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

Available on crate feature default_client only.

fn from(e: Utf8Error) -> Self

Converts to this type from the input type.