HTTP头或响应正文中的Rest错误消息？

Question

我有一个REST服务，它暴露在iPhone和Android客户端上。目前我遵循HTTP代码200、400、401、403、404、409、500等。

< HTTP/1.1 400 Bad Request - Missing Required Parameters.
< Date: Thu, 20 Dec 2012 01:09:06 GMT
< Server: Apache/2.2.22 (Ubuntu)
< Connection: close
< Transfer-Encoding: chunked

还是通过JSON将其放在响应体中更好？

< HTTP/1.1 400 Bad Request
< Date: Thu, 20 Dec 2012 01:09:06 GMT
< Server: Apache/2.2.22 (Ubuntu)
< Connection: close
< Transfer-Encoding: chunked
< Content-Type: application/json
{ "error" : "Missing Required Parameters" }

Answer 1

引用400.x错误代码的HTTP规范：

状态代码的4xx类用于客户端似乎出错的情况。除了响应一个HEAD请求时，服务器应该包括一个实体，其中包含对错误情况的解释，以及它是暂时的还是永久的情况。这些状态代码适用于任何请求方法。用户代理应向用户显示任何包含的实体。

最佳实践是将错误消息作为一个实体包含在HTTP响应的正文中--不管是JSON、纯文本、格式化的HTML还是您想要使用的任何其他格式。