Enum WebError 

pub enum WebError {
    InvalidRequest {
        message: String,
    },
    Unauthorized {
        reason: String,
    },
    Forbidden {
        reason: String,
    },
    NotFound {
        resource: String,
    },
    ContentTooLarge {
        size: usize,
        max: usize,
    },
    RateLimited {
        retry_after_secs: u64,
    },
    ProcessingError(String),
    InternalError {
        message: String,
    },
    ServiceUnavailable {
        reason: String,
    },
    GatewayTimeout {
        timeout_ms: u64,
    },
}

HTTP-level error with status codes and structured JSON responses.

This error type is designed for web API responses, providing:

• Appropriate HTTP status codes
• Structured JSON error bodies
• Request ID correlation for tracing
• Logging integration

JSON Response Format

{
    "error": "Human-readable error message",
    "code": "ERROR_CODE",
    "request_id": "optional-request-id"
}

Variants

InvalidRequest

Invalid request - malformed input, missing fields, validation failures HTTP Status: 400 Bad Request

Fields

message: String

Detailed error message

Unauthorized

Unauthorized - authentication required or invalid credentials HTTP Status: 401 Unauthorized

Fields

reason: String

Reason for authorization failure

Forbidden

Forbidden - authenticated but not permitted HTTP Status: 403 Forbidden

Fields

reason: String

Reason access was denied

NotFound

Resource not found HTTP Status: 404 Not Found

Fields

resource: String

Description of the missing resource

ContentTooLarge

Request content too large HTTP Status: 413 Payload Too Large

Fields

size: usize

Actual size of the content

max: usize

Maximum allowed size

RateLimited

Rate limit exceeded HTTP Status: 429 Too Many Requests

Fields

retry_after_secs: u64

Number of seconds to wait before retrying

ProcessingError(String)

Processing error - operation failed during execution HTTP Status: 500 Internal Server Error

InternalError

Internal server error - unexpected failures HTTP Status: 500 Internal Server Error

Fields

message: String

Error message (sanitized for external display)

ServiceUnavailable

Service unavailable - temporarily unable to handle request HTTP Status: 503 Service Unavailable

Fields

reason: String

Reason the service is unavailable

GatewayTimeout

Gateway timeout - upstream service timed out HTTP Status: 504 Gateway Timeout

Fields

timeout_ms: u64

Timeout duration in milliseconds

Implementations

impl WebError

pub fn invalid_request(message: impl Into<String>) -> Self

Create an invalid request error with a message

pub fn missing_field(field: &str) -> Self

Create an invalid request error for a missing field

pub fn invalid_field(field: &str, reason: &str) -> Self

Create an invalid request error for an invalid field value

pub fn unauthorized(reason: impl Into<String>) -> Self

Create an unauthorized error

pub fn forbidden(reason: impl Into<String>) -> Self

Create a forbidden error

pub fn not_found(resource: impl Into<String>) -> Self

Create a not found error

pub fn content_too_large(size: usize, max: usize) -> Self

Create a content too large error

pub fn rate_limited(retry_after_secs: u64) -> Self

Create a rate limited error

pub fn processing<E: Display>(source: E) -> Self

Create a processing error from any error type

pub fn internal(message: impl Into<String>) -> Self

Create an internal error with a message

pub fn internal_from<E: Error>(err: E) -> Self

Create an internal error from any error, sanitizing the message

pub fn service_unavailable(reason: impl Into<String>) -> Self

Create a service unavailable error

pub fn gateway_timeout(timeout_ms: u64) -> Self

Create a gateway timeout error

pub fn status_code(&self) -> u16

Get the HTTP status code for this error

pub fn error_code(&self) -> &'static str

Get the error code string for this error

pub fn to_json(&self) -> Value

Convert error to JSON response body

pub fn to_json_with_request_id(&self, request_id: &str) -> Value

Convert error to JSON response body with request ID

pub fn log(&self, request_id: Option<&str>)

Log the error with appropriate level and optional request ID

pub fn is_retryable(&self) -> bool

Check if this error should be retried

pub fn retry_after(&self) -> Option<u64>

Get retry-after header value if applicable

Trait Implementations

impl Clone for WebError

fn clone(&self) -> WebError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WebError

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

Formats the value using the given formatter.

impl Display for WebError

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

Formats the value using the given formatter.

impl Error for WebError

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<&WebError> for ErrorResponse

fn from(err: &WebError) -> Self

Converts to this type from the input type.

impl From<Error> for WebError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WebError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WebError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<WebError> for Error

fn from(source: WebError) -> Self

Converts to this type from the input type.