用于可选功能参数的REST GET设计

Question

我有一个包装在REST端点中的预测模型。在后台，/forecast端点根据GET参数feature_name从数百种模型中选择一种进行预测。

我们有一个用例，可以通过一个HTTP请求从所有模型获得所有预测。我们应该：

1. 将feature_name设为可选，如果未传递任何内容，则返回所有模型的预测吗？
2. 如果用户想要所有预测，让用户将'all'这样的特殊词传递给feature_name？
3. 要维护两个端点forecast和forecast_all吗？
4. 我没想到的事吗？

Answer 1

使用/foo/{id}的端点用于单个项目，而单独使用/foo/来获取所有项目的集合的想法非常普遍。

我特别建议研究REST集合的标准格式。 HAL是受欢迎的。

前一段时间，我写了an article关于REST服务中的集合。也许对于更多上下文也很有帮助。