Enum matrix_sdk::HttpError

pub enum HttpError {
    Reqwest(ReqwestError),
    AuthenticationRequired,
    NotClientRequest,
    Api(FromHttpResponseError<RumaApiError>),
    IntoHttp(IntoHttpError),
    UiaaError(FromHttpResponseError<UiaaError>),
    Server(StatusCode),
    UnableToCloneRequest,
    RefreshToken(RefreshTokenError),
}

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

Variants

Reqwest(ReqwestError)

An error at the HTTP layer.

AuthenticationRequired

Queried endpoint requires authentication but was called on an anonymous client.

NotClientRequest

Queried endpoint is not meant for clients.

Api(FromHttpResponseError<RumaApiError>)

An error converting between ruma_*_api types and Hyper types.

IntoHttp(IntoHttpError)

An error converting between ruma_client_api types and Hyper types.

UiaaError(FromHttpResponseError<UiaaError>)

An error occurred while authenticating.

When registering or authenticating the Matrix server can send a UiaaResponse as the error type, this is a User-Interactive Authentication API response. This represents an error with information about how to authenticate the user.

Server(StatusCode)

The server returned a status code that should be retried.

UnableToCloneRequest

The given request can’t be cloned and thus can’t be retried.

RefreshToken(RefreshTokenError)

An error occurred while refreshing the access token.

Implementations

impl HttpError

pub fn 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

impl Debug for HttpError

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

Formats the value using the given formatter.

impl Display for HttpError

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

Formats the value using the given formatter.

impl Error for HttpError

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

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 self, demand: &mut Demand<'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 HttpError

fn from(source: ReqwestError) -> Self

Converts to this type from the input type.

impl From<FromHttpResponseError<Error>> for HttpError

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

Converts to this type from the input type.

impl From<FromHttpResponseError<MatrixError>> for HttpError

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

Converts to this type from the input type.

impl From<FromHttpResponseError<UiaaResponse>> for HttpError

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

Converts to this type from the input type.

impl From<HttpError> for ClientBuildError

fn from(source: HttpError) -> Self

Converts to this type from the input type.

impl From<HttpError> for Error

fn from(source: HttpError) -> Self

Converts to this type from the input type.

impl From<HttpError> for ManualVerifyError

Available on crate feature e2e-encryption only.

fn from(source: HttpError) -> Self

Converts to this type from the input type.

impl From<IntoHttpError> for HttpError

fn from(source: IntoHttpError) -> Self

Converts to this type from the input type.

impl From<RefreshTokenError> for HttpError

fn from(source: RefreshTokenError) -> Self

Converts to this type from the input type.