http - 我可以使用 HTTP 状态代码的自定义原因来区分 REST API 的错误吗

Question

我想区分不同类型的“未找到”错误。例如给出以下请求:

GET/author/Adams/works/HHGTTG

要么“找不到”作者，要么“找不到”作品，我想区分这两者。

状态:404 - 找不到作者
状态:404 - 找不到工作

根据规范，可以更改原因短语。 http://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html

6.1.1 Status Code and Reason Phrase

...The reason phrases listed here are only recommendations -- they MAY be replaced by local equivalents without affecting the protocol...

对于同一个状态码使用两个独特的短语是否也可以接受？

而且，这是一种合理的方法还是有更好的约定来指示更细粒度的错误？

最终我想要一个可以抛出 AuthorNotFound 或 WorkNotFound 异常而不是通用 AuthorOrWorkNotFound 异常的客户端库。

Answer 1

您可以让 HTTP 响应的主体包含一条消息，您可以使用任何其他信息对其进行解析。

状态代码(在响应中)的 HTTP 状态消息可以是您想要的任何内容，并且不会影响任何客户端。 HTTP 客户端通常会忽略消息文本。