Struct ApiError 

pub struct ApiError {
    pub status: StatusCode,
    pub message: String,
    pub request_id: Option<RequestId>,
}

A handler error with an HTTP status and a user-safe message.

Fields

status: StatusCode

HTTP status.

message: String

Human-readable message.

request_id: Option<RequestId>

Transport request identity for tracing and idempotency.

Implementations

impl ApiError

pub fn new(status: StatusCode, message: impl Into<String>) -> Self

An error envelope with an explicit status.

pub fn localized( status: StatusCode, catalog: &I18n, locale: &str, key: &str, args: &[(&str, &str)], ) -> Self

An error whose user-safe message resolves through the shared catalog.

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

HTTP 400.

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

HTTP 404.

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

HTTP 500.

pub fn with_request_id(self, id: RequestId) -> Self

Attach the request id (the latency/request-id middleware sets one).

Trait Implementations

impl Clone for ApiError

fn clone(&self) -> ApiError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ApiError

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

Formats the value using the given formatter.

impl IntoResponse for ApiError

fn into_response(self) -> Response

Create a response.