Problem Details for HTTP APIs (RFC 7807)

[daniel-mader]

Description

Readability and conciseness of errors via the HTTP API (agent_api_rest) can be improved when following the Problem Details for HTTP APIs (RFC 7807). It introduces a "standard" way to report errors back to the caller.

Motivation

Enhanced API experience for the consumer.
We also want a more easy way to handle errors other than manually returning

return StatusCode::INTERNAL_SERVER_ERROR.into_response();

There are multiple options to explore:

• make use of the framework's error handling
• propagate the error (using thiserror and ?) and build a custom error handler / mapper

Requirements

1. read and understand the scope of the RFC 7807
2. search for a crate to make implementation easier (possibly this one)
3. implement and test

Open Questions

No response

Are you planning to contribute this in a PR?

Yes

[nanderstabel]

(partially) depends on:impierce/openid4vc#78