Enum Error 

pub enum Error {
    MalformedMultipart,
    BadRequest(String),
    StreamReadError,
    MissingField,
    IoError(Error),
    Unauthorized(String),
    Internal(Error),
    NotFound(String),
    InvalidHeader(InvalidHeaderValue),
}

Errors that can occur while processing an HTTP API request.

These are split into two categories:

• Client errors (4xx): Safe to return directly to the caller. They indicate the client sent something malformed or unauthorized.
• Internal errors (5xx): Must never expose implementation details. The IntoResponse implementation strips these down to a generic message before sending.

Variants

MalformedMultipart

The multipart form body was structurally invalid and could not be parsed.

BadRequest(String)

The client sent a request that violates the API contract. The inner String contains a human-readable explanation safe to send back.

StreamReadError

Reading the request body stream failed mid-transfer. This is typically a network issue on the client side.

MissingField

A required field was absent from the request body or headers.

IoError(Error)

An I/O error occurred while processing the request, such as writing a temporary file to disk. This is an internal failure.

Unauthorized(String)

The request could not be authenticated. The inner String contains a message safe to return (e.g., “Missing Header”, “Invalid token”).

Internal(Error)

A low-level internal error, typically from integer or time conversions.

NotFound(String)

The requested resource does not exist or is not accessible to the caller. The inner String contains a message safe to return to the client.

InvalidHeader(InvalidHeaderValue)

A header value provided in the response could not be parsed. This is almost always a bug in the server code, not the client.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for Error

fn from(source: InvalidHeaderValue) -> Self

Converts to this type from the input type.

impl IntoResponse for Error

fn into_response(self) -> Response

Create a response.

impl Loggable for Error

fn log_level(&self) -> Level

Returns the severity level that should be assigned to this error in the log.

fn log_module(&self) -> Module

Returns the server module responsible for this error.