Enum matrix_sdk::HttpError

source ·
pub enum HttpError {
    Reqwest(Error),
    NotClientRequest,
    Api(FromHttpResponseError<RumaApiError>),
    IntoHttp(IntoHttpError),
    RefreshToken(RefreshTokenError),
}
Expand description

An HTTP error, representing either a connection error or an error while converting the raw HTTP response into a Matrix response.

Variants§

§

Reqwest(Error)

Error at the HTTP layer.

§

NotClientRequest

Queried endpoint is not meant for clients.

§

Api(FromHttpResponseError<RumaApiError>)

API response error (deserialization, or a Matrix-specific error).

§

IntoHttp(IntoHttpError)

Error when creating an API request (e.g. serialization of body/headers/query parameters).

§

RefreshToken(RefreshTokenError)

Error while refreshing the access token.

Implementations§

source§

impl HttpError

source

pub fn as_ruma_api_error(&self) -> Option<&RumaApiError>

If self is Api(Server(e)), returns Some(e).

Otherwise, returns None.

source

pub fn as_client_api_error(&self) -> Option<&Error>

source§

impl HttpError

source

pub fn client_api_error_kind(&self) -> Option<&ErrorKind>

If self is a server error in the errcode + error format expected for client-API endpoints, returns the error kind (errcode).

source

pub fn as_uiaa_response(&self) -> Option<&UiaaInfo>

Try to destructure the error into an universal interactive auth info.

Some requests require universal interactive auth, doing such a request will always fail the first time with a 401 status code, the response body will contain info how the client can authenticate.

The request will need to be retried, this time containing additional authentication data.

This method is an convenience method to get to the info the server returned on the first, failed request.

Trait Implementations§

source§

impl Debug for HttpError

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for HttpError

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for HttpError

source§

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0 · source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
source§

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. Read more
source§

impl From<Error> for HttpError

source§

fn from(source: ReqwestError) -> Self

Converts to this type from the input type.
source§

impl From<FromHttpResponseError<Error>> for HttpError

source§

fn from(err: FromHttpResponseError<Error>) -> Self

Converts to this type from the input type.
source§

impl From<FromHttpResponseError<MatrixError>> for HttpError

source§

fn from(err: FromHttpResponseError<MatrixError>) -> Self

Converts to this type from the input type.
source§

impl From<FromHttpResponseError<RumaApiError>> for HttpError

source§

fn from(source: FromHttpResponseError<RumaApiError>) -> Self

Converts to this type from the input type.
source§

impl From<FromHttpResponseError<UiaaResponse>> for HttpError

source§

fn from(err: FromHttpResponseError<UiaaResponse>) -> Self

Converts to this type from the input type.
source§

impl From<HttpError> for ClientBuildError

source§

fn from(source: HttpError) -> Self

Converts to this type from the input type.
source§

impl From<HttpError> for Error

source§

fn from(source: HttpError) -> Self

Converts to this type from the input type.
source§

impl From<HttpError> for ManualVerifyError

source§

fn from(source: HttpError) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, W> HasTypeWitness<W> for T
where W: MakeTypeWitness<Arg = T>, T: ?Sized,

source§

const WITNESS: W = W::MAKE

A constant of the type witness
source§

impl<T> Identity for T
where T: ?Sized,

§

type Type = T

The same type as Self, used to emulate type equality bounds (T == U) with associated type equality constraints (T: Identity<Type = U>).
source§

const TYPE_EQ: TypeEq<T, <T as Identity>::Type> = TypeEq::NEW

Proof that Self is the same type as Self::Type, provides methods for casting between Self and Self::Type.
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> Any for T
where T: Any,

source§

impl<T> AsyncTraitDeps for T

source§

impl<T> SendOutsideWasm for T
where T: Send,

source§

impl<T> SyncOutsideWasm for T
where T: Sync,