Struct ApiError 

pub struct ApiError {
    pub status: StatusCode,
    pub code: String,
    pub message: String,
    pub details: Option<Value>,
}

Standardized API error.

Fields

status: StatusCode

code: String

message: String

details: Option<Value>

Implementations

impl ApiError

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

Build an error with explicit status, code, and message.

pub fn with_details(self, details: Value) -> Self

Attach a structured details payload (e.g. field-error map).

pub fn with_field(self, field: impl Into<String>) -> Self

Convenience: attach {"field": "..."} details.

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

400 Bad Request — code = "bad_request".

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

401 Unauthorized — code = "unauthorized".

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

403 Forbidden — code = "forbidden".

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

404 Not Found — code = "not_found".

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

409 Conflict — code = "conflict".

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

422 Unprocessable Entity — code = "validation_failed".

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

429 Too Many Requests — code = "rate_limited".

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

500 Internal Server Error — code = "internal_error".

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

503 Service Unavailable — code = "service_unavailable".

pub fn to_json(&self) -> Value

Render to a JSON value (without going through IntoResponse).

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 Display for ApiError

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

Formats the value using the given formatter.

impl Error for ApiError

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<ApiError> for ProblemDetails

Available on crate feature admin only.

fn from(e: ApiError) -> Self

Converts to this type from the input type.

impl IntoResponse for ApiError

fn into_response(self) -> Response

Create a response.