複数のパラメータを持つGET HTTPリクエストを処理するREST APIの有効なURIテンプレートは何ですか？

Question

2つのパラメータを必要とするGETリクエストを処理するRESTful APIを開発しています。

私は、ユースケースをよりよく説明しよう：このAPIは、特定の市場における特定の商品（commodity_idが一つのパラメータである）（market_id 2番目のパラメータである）の最新の価格を返します。

このような理由から有効なURIテンプレートは何ですか？このような

何か：

このような

/latest_commodity_price/{commodity_id}/{market_id} 

か何か：

/latest_commodity_price/{commodity_id}?market_id={market_id} 

か何かのように：

/latest_commodity_price?commodity_id={commodity_id}&market_id={market_id} 

それとも他に何？

Answer 1

あなたのアプローチは間違った位置から始まります。 RESTはリソースを照会していることを意味します。したがって、URIは、あなたのAPIをクエリしているリソースから始める必要があります。

/commodity/{commondity_id} 

次に、市場の価格のリストを用意したいとします。商品の価格リストを取得するためにAPIをクエリするような音です。

/commodity/{commondity_id}/prices 

最後に、価格リストをフィルタリングしています。クエリパラメータでフィルタリングすることをおすすめします。

/commodity/{commondity_id}/prices?market_id={market_id}&latestPrice=1