HTTP头状态是否与RESTful调用的正文状态匹配

Question

构建RESTful web服务endpoint，并考虑HTTP头状态与响应正文中找到的状态的最佳实践是什么。它们应该总是匹配的，还是可以是不同的？例如，在一个坏请求的情况下，实际上是我们的应用层对有效负载进行解析和处理。因此，在请求发送到应用层的情况下，HTTP报头是否显示200（表示传输没有问题），而响应体是否包含400（表示错误的请求）？还是他们应该一直匹配？头部和身体都有400？

多谢了。

Answer 1

一般来说，一以贯之是一种好的做法。因此，如果您打算在JSON正文中返回HTTP状态代码，那么它应该与HTTP状态代码相同。

如果要添加更多有关应用程序错误的详细信息。JSON-API标准为JSON错误体定义了一些字段，例如：

• 代码：应用程序特定的错误代码，表示为字符串值。例如，HTTP 400状态代码可能有不同的代码。
• 标题：对问题的简短、可读的摘要，除非出于本地化的目的，该摘要不应因问题的发生而改变。
• 详细信息：特定于该问题发生的人类可读的解释。与title一样，该字段的值可以本地化。

GET /artists/:artist_id/songs/:id

1. 找不到艺术家时
2. 找不到歌曲时

对于这两种情况，您都将返回一个HTTP404状态代码。但是,在json主体中,可以添加更多的细节：

• 找不到艺术家时
  • 代码:10
  • 标题：找不到艺术家
  • 详细信息：id为{artist_id}的艺术家不存在
  null