Enum HttpError

pub enum HttpError {
    Reqwest(Error),
    NotClientRequest,
    Api(FromHttpResponseError<RumaApiError>),
    IntoHttp(IntoHttpError),
    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(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

impl HttpError

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

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

Otherwise, returns None.

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

Shorthand for .as_ruma_api_error().and_then(RumaApiError::as_client_api_error).

impl HttpError

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).

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

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)>

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 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<RumaApiError>> for HttpError

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

Converts to this type from the input type.

impl From<FromHttpResponseError<UiaaResponse>> for HttpError

fn from(err: FromHttpResponseError<UiaaResponse>) -> 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<HttpError> for SecureChannelError

Available on crate feature experimental-oidc and crate feature e2e-encryption and non-WebAssembly only.

fn from(source: HttpError) -> Self

Converts to this type from the input type.