特定のユーザーに属するオーダーの一覧を返すREST APIの名前を付けるにはどうすればよいですか？

Question

我々はユーザーに属する注文のすべてを返すためのREST API

/accounts/{user_id}/shop/orders 

を持っています。

今、特定の注文番号で注文を返す新しいAPIを追加します。

/accounts/{user_id}/shop/orders/order?orders=a,b,c,d 

私は別のコントローラにマッピングすることにしたいので、私は、元/accounts/{user_id}/shop/ordersに新しいAPIに名前を付けることはできません。

しかし、私は/accounts/{user_id}/shop/orders/order?orders=a,b,c,dがちょっと変わっていると思うので、その場合の名前は何ですか？

Answer 1

ここで私は今あなたが考えているあなたの状況で働くことができると思われる提案ですは2つのコントローラの異なるエンドポイントを持っている必要があります。

/accounts/{user_id}/shop/orders/all 

または

/accounts/{user_id}/shop/orders/list 

第二1はリストが完全であることを意味するものではありませんので、（私は、より良い最初のものが好き：ユーザーに属する注文のすべてを返すように

）

は、特定の注文番号で注文を戻すには：

/accounts/{user_id}/shop/orders/filtered?number=a,b,c,d 

---

このようにして、両方のエンドポイントの機能を明確に区別することができますが、両方ともそこに属しているので、両方とも/accounts/{user_id}/shop/ordersに転送できます。