利用可能なデータがない場合のHTTP戻りコード

Question

たとえば、実際には常に存在するapiメソッド/api/orders.getOrdersがあります。 このメソッドが次の形式のデータを返さない場合、404または200のHTTP応答コードを送信する必要がありますか？

{ "orders":[] }

Answer 1

は正しいです。 RFC 7231

の4xx（クライアントエラー）ステータスコードのクラスから

は、クライアントが誤りを犯しているように見えることを示しています。

404（見つかりません）ステータスコードはオリジンサーバがターゲット資源あなたのケースで

の現在の表現を見つけられなかったことを示し、クライアントははないを求める中でミスをしませんでしたリソース;オリジンサーバーはリソースの現在の表現を見つけました。したがって、404（実際には4xxクラスの応答全体）は適切ではありません。

204 is also wrong。

ステータスコード204は、サーバーが要求を正常に実行したこと、および応答ペイロード本体に送信する追加のコンテンツがないことを示します。

「内容なし」は、HTTP応答メッセージ本文が空であることを意味します。つまり、返される表現は0バイトです。空のリソースの空でない表現を返すときは適切ではありません。