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

【问题标题】：What could be a valid URI template for REST API handling a GET HTTP request with multiple parameters?什么是 REST API 处理具有多个参数的 GET HTTP 请求的有效 URI 模板？
【发布时间】：2017-10-09 12:25:36
【问题描述】：

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

我尝试更好地解释用例：此 API 将返回特定市场（market_id）中特定商品的最新价格（commodity_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}

或者还有什么？

【问题讨论】：

标签： rest api web-services restful-url

【解决方案1】：

在 RESTful 方式中，您的方法从错误的位置开始。 REST 表示您正在查询资源。所以 URI 应该以您查询 API 的资源开头。

/commodity/{commondity_id}

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

/commodity/{commondity_id}/prices

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

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

【讨论】：