Struct RequestError 

#[non_exhaustive]
pub struct RequestError { /* private fields */ }

A request-level JMAP error response: HTTP status code + JMAP error body.

Used when an error occurs before method dispatch (e.g., parse failure, unknown capability). Derives the HTTP status from the error type via error_status. Use request_error to construct.

Call RequestError::into_response to produce an http::Response<String> with the RFC 7807 Problem Details body. Any HTTP framework that works with the http crate (axum, hyper, warp, etc.) accepts this directly.

Implementations

impl RequestError

pub fn into_response(self) -> Response<String>

Convert into an HTTP response with an RFC 7807 Problem Details body.

The Content-Type is application/problem+json. The body is a JSON object with at minimum "type" (full URN) and "status" fields per RFC 7807 §3.1, plus "limit" for limit errors (RFC 8620 §3.6.1).

Trait Implementations

impl Debug for RequestError

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

Formats the value using the given formatter.

impl Display for RequestError

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

Render as "<status>: <error_type>[: <description>]" for log/diagnostic output. The HTTP status is included because RequestError is the request-level error type and the status is the most actionable field for operators.

impl Error for RequestError

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<JmapError> for RequestError

fn from(err: JmapError) -> Self

Convert a JmapError into a RequestError, deriving the HTTP status code automatically via error_status.

Enables ? propagation in functions returning Result<_, RequestError>. Pass only request-level errors; see error_status for the safe list.