0

シェルフを壁に POSTS する API メソッドがあるとします。

POST /api/shelve  {wallId: 0, shelveTitle: "a shelve for my favorite books"}

そして、本を棚に POSTS する別の方法があります。

POST /api/book {shelveId: 0, bookTitle: "my book"}

構文と使いやすさの観点から、上記の URL (薄い URL、ファット ボディ) と、次のようなより詳細な URL のどちらを使用しますか。

POST /api/shelve/0/book {bookTitle: "my book"}

/api/book と言って URL をできるだけシンプルに保ち、すべての仕様/定義を本文に委譲し、URL を動詞/名詞のペアに制限したいと思います。私は API にまったく慣れていないので、うまくいきたいと思っています... このシナリオの規則は何ですか?

4

1 に答える 1

0

個人的には一緒に行きます

POST /api/shelve/0/book {bookTitle: "my book"}

単に本を追加するのではなく、棚に本を追加していることは明らかだからです。

REST の設計についてはさまざまな意見がありますが、この小さな無料の本を強くお勧めします: Web Api Design

于 2013-03-27T16:13:35.137 に答える