Struct Problem 

pub struct Problem {
    pub type_uri: String,
    pub title: String,
    pub status: u16,
    pub detail: Option<String>,
    pub instance: Option<String>,
    pub extensions: Map<String, Value>,
}

RFC 9457 problem details response.

Fields

type_uri: String

title: String

status: u16

detail: Option<String>

instance: Option<String>

extensions: Map<String, Value>

Implementations

impl Problem

pub fn new( type_uri: impl Into<String>, title: impl Into<String>, status: u16, ) -> Self

Create a problem with a fully-qualified type_uri.

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

Human-readable explanation of the specific occurrence.

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

URI reference that identifies the specific occurrence.

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

Attach a custom extension member (serialisable value).

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

Override the title (fluent).

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

404 Not Found.

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

400 Bad Request.

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

401 Unauthorized.

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

403 Forbidden.

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

409 Conflict.

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

422 Unprocessable Entity.

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

429 Too Many Requests.

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

500 Internal Server Error.

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

503 Service Unavailable.

pub fn from_validation(errors: HashMap<String, Vec<String>>) -> Self

Build an unprocessable-entity problem from a map of field → errors.

pub fn to_json_bytes(&self) -> Vec<u8>

Serialize to a JSON byte vec.

On serialization failure, logs the error and returns b"{}" as a minimal RFC 9457-compliant fallback.

Trait Implementations

impl Clone for Problem

fn clone(&self) -> Problem

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

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.