rest - REST APIの空のサブリソースに使用するHTTPコードはどれですか？

Question

articlesにリソースがあるとしましょう/articles。

これらの記事には関連記事がある可能性があるため、GETを使用して取得します/articles/{id}/related。

関連記事がないのですが、何を返却すればよいですか？

私は考えることができます：

• 404 Not Found、おそらく空のコレクションで
• 204 No Content
• 200 Found空のコレクションで

何かアドバイスはありますか？（議論をお願いします）

ちなみに、ページネーションにも当てはまるかもしれません。2ページ中3ページをリクエストすると、3ページは空のセットを返し404ます。

Answer 1

私は使用しません-それはクライアントに「関連する記事があるかどうか404をあなたに伝えることができない」と言うでしょう。指定された{id}がまったく認識されない場合は適切です。あなたが望むのは、クライアントに良い質問をするための肯定的な応答です。これが関連記事の（空の）リストです。

204関連する理由から、どちらも良くありません。答えがないことを指定しました。これは、そこにある答えとはまだ異なりますが、たまたま空のリストです。POSTその説明は、よりもaの方が理にかなっていGETます。

200空のリストでちょうどいいです。

Answer 2

空の配列で200を返します。