search

ietf-wg-httpapi / rfc7807bis

Revision of RFC7807: HTTP Problem Details
Other
20 stars 8 forks source link

Discuss usage of application/json #44

Closed dret closed 2 years ago

dret commented 2 years ago

What about a short paragraph/section saying that APIs using the spec don't require clients to always add Accept with the problem-specific media types? I've now had several people asking this very question, and maybe we could clarify this by saying "HTTP allows you to respond with media types other than those listed in Accept."

dret commented 2 years ago

Because I am curious to see what people think: https://twitter.com/dret/status/1526218691603464192

mnot commented 2 years ago

We shouldn't restate or explain HTTP in our prose -- it's a specification, not a tutorial. Extrinsic materials can handle that.

However, we can include an example that includes a request without Accept.

dret commented 2 years ago

On 2022-05-16 23:52, Mark Nottingham wrote:

We shouldn't restate or explain HTTP in our prose -- it's a specification, not a tutorial. Extrinsic materials can handle that. However, we can include an example that includes a request without Accept.

ok, sounds good. but if we do that then we should at least mention that we're showing this because servers are free to respond with the application/problem+json media type, even if clients don't specifically request it. is that ok for you?