HTTPヘッダーまたは応答本文にエラーメッセージを残しますか？

iPhoneおよびAndroidクライアントに公開されているRESTサービスがあります。現在、私はHTTPコード200、400、401、403、404、409、500などに従います。

私の質問は、エラーの理由/説明/原因を置くための推奨される場所はどこですか？このように、REST APIのヘッダーに常にカスタムReasonを含める方が理にかなっていますか？

< 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" }

400.xエラーコードのHTTP仕様からの引用：

4xxクラスのステータスコードは、クライアントがエラーを起こしているように見える場合を対象としています。HEADリクエストに応答する場合を除いて、サーバーには、エラー状況の説明と、それが一時的または永続的な状態であるかどうかを含むエンティティを含める必要があります。これらのステータスコードは、すべてのリクエスト方法に適用できます。ユーザーエージェントは、含まれているエンティティをユーザーに表示する必要があります。

エラーメッセージをHTTP応答の本文にエンティティとして含めることをお勧めします。JSON、プレーンテキスト、フォーマットされたHTML、またはその他の利用したいフォーマットです。

本文にエラーの詳細を含めることをお勧めします。さらに、多くの（ほとんど/ほとんどすべて、たとえばWSGI）サーバーとクライアントはエラーコードの名前の変更をサポートしていません-それらを固定ペアとして扱います（たとえば、400は常に「悪いリクエスト」であり「悪いリクエスト」ではありません-あなたユーザーIDの指定を忘れた」）。彼らが壊れなくても、彼らは特定のエラーコードのあなたの特別な名前を気にしません。

エラーは本文に属していません。これはWarningヘッダーに属します。

警告の一般的なHTTPヘッダーには、メッセージのステータスで発生する可能性のある問題に関する情報が含まれています。

参照