http-extensions icon indicating copy to clipboard operation
http-extensions copied to clipboard

Accept-Query scope

Open mnot opened this issue 3 years ago • 0 comments

Right now, the spec says:

The "Accept-Query" response header field MAY be used by a server to directly signal support for the QUERY method while identifying the specific query format media type(s) that may be used.

The use of 'server' here implies that if a client gets a response from e.g., https://example.com/foo that contains Accept-Query, that client can infer that all other resources on the server support the listed media type(s).

That seems like it's overstating things; other resources on the server might accept other formats, or not accept QUERY at all (indeed, most may not). Given how disruptive such a change would be (e.g., to caching), it seems like a more cautious approach is warranted.

So, I suggest specifying 'resource', not 'server', and explaining the implications in some more detail.

I'm aware that Accept-Patch and Accept-Post both say 'server', but I think that's more from a history of imprecision. Also, neither of those can be read to imply that the specified method is preferred in place of another (especially one as widely used as GET).

mnot avatar Feb 02 '22 05:02 mnot