什么是REST处理带有多个参数的GET HTTP请求的有效URI模板？

Question

我正在开发一个GET API，它处理需要2个参数的GET请求。

我试图更好地解释用例:这个API将返回特定商品的最新价格( commodity_id是一个参数)( market_id是第二个参数)。

那么，什么才是有效的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

在RESTful中，您的方法从错误的位置开始。REST意味着您正在查询资源。因此，URI应该从查询API所需的资源开始。

/commodity/{commondity_id}

然后你想要一个市场的价格清单。这听起来像是在查询API以检索商品的价格列表：

/commodity/{commondity_id}/prices

最后，您正在筛选价格列表。我建议使用查询参数进行筛选：

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