http - URL パラメーターを使用した HTTP POST - サーバーは何を返す必要がありますか?

Question

さまざまなドメイン オブジェクトに CRUD 操作を提供する RESTFul サービスの設計に取り組んでいます。そのようなオブジェクトの 1 つが Person です。

次のサービスがあります。

GET /person/list?type=Infant

タイプが幼児のすべての人に応答します。

POST /person/list

ペイロード内の人のリストを受け入れ、それらのレコードを作成します。

質問: 理にかなっていますか?

POST /person/list?type=Infant

その場合、ペイロードで渡された人を作成してから、幼児タイプのすべての人のリストで応答しますか?

ベストプラクティスは何ですか?

Answer 1

「ペイロードで渡された人物を作成し、タイプが幼児のすべての人物のリストで応答する」というステートメントには満足できません。2 つの操作は別々に実行する必要があります。

Answer 2

/person/list が人を追加するための API であることはあまり意味がないと思います。どちらかといえば、/person/add である必要があります。利口になることを禁じる REST に関する具体的なことは何もありませんが、/person/add に対して私が期待する応答は、add の結果です。いくつかの追加機能を移植しようとすると、クライアント (つまり、API を使用する人々) にとって複雑になります。