Struct Problem 

pub struct Problem {
    pub slug: &'static str,
    pub status: StatusCode,
    pub title: &'static str,
    pub detail: Option<String>,
    pub instance: Option<String>,
    /* private fields */
}

An API error, serialized as application/problem+json.

type is the venture’s stable slug URI (see Problem::type_uri), instance is the request id, and the body never leaks internals: 500s carry no stack, no source error, nothing but the generic internal slug.

Fields

slug: &'static str

status: StatusCode

title: &'static str

detail: Option<String>

instance: Option<String>

Implementations

impl Problem

pub fn new(def: &ProblemDef) -> Self

pub fn with_detail(self, detail: impl Into<String>) -> Self

pub fn with_extension( self, name: impl Into<String>, value: impl Into<Value>, ) -> Self

Adds an RFC 9457 §3.2 extension member to the body.

pub fn instance(self, request_id: &str) -> Self

Sets instance to the request’s id.

pub fn internal() -> Self

pub fn validation_failed(detail: impl Into<String>) -> Self

pub fn request_too_large() -> Self

pub fn not_ready(detail: impl Into<String>) -> Self

pub fn not_found() -> Self

pub fn type_uri(&self, base: &str) -> String

The problem’s type URI: the venture’s base followed by the slug.

The base is the serving venture’s — crate::Venture::problem_type_base — never a constant of this crate: every venture names its problems under its own domain. A base of ABOUT_BLANK (the context-free default, and a venture with no public URL) yields about:blank itself: the slug has no URI to live under, and RFC 9457 §4.2.1 reserves exactly that value.

pub fn into_response_with_base(self, base: &str) -> Response

Renders this problem as a response whose type names base — the serving venture’s crate::Venture::problem_type_base. For a response built outside a harness router, where no layer stands behind it to name the venture: a runtime’s pre-router short-circuit (the native host refusal, the Worker’s body ceiling).

Trait Implementations

impl Clone for Problem

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Problem

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

Formats the value using the given formatter.

impl Display for Problem

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

Formats the value using the given formatter.

impl Error for Problem

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<DbError> for Problem

fn from(error: DbError) -> Self

Converts to this type from the input type.

impl From<StreamError> for Problem

A mid-stream failure is a Problem: a ceiling breach is exactly the 413 request-too-large a buffered route answers with, and a transport failure is a server-side fault the caller cannot fix, so it becomes the generic 500 internal (the same mapping crate::ports::DbError gets — no internals in the body, the error only logged).

fn from(error: StreamError) -> Self

Converts to this type from the input type.

impl IntoResponse for Problem

fn into_response(self) -> Response

Create a response.