postgresql - REST API 何时使用查询参数或请求参数？

Question

我有一个数据库，其中包含一个包含workout-plans 的表。数据示例如下:

{
  id: 1,
  level: 'beginner'
  week_index: 1
},
{
  id: 2,
  level: 'beginner'
  week_index: 2
},
{
  id: 3,
  level: 'advanced'
  week_index: 1
}

使用 week_index 和 level 获取特定项目的最佳方法是什么。这些是我目前的想法，但我不知道 REST API 的最佳实践。

/workout-plans?level=beginner&week=1
/workout-plans/beginner/1
/workout-plans/beginner?week=1

Answer 1

/workout-plans/ 是锻炼计划列表的路径。所以它总是返回一个列表，即使只有 1 个结果。

因此 /workout-plans/?level=beginner&week=1 产生 1 个结果，但作为列表。

如果这是解决其中一个问题的理想方式(按级别和周，而不是按 id)，那么获取其中一个的 URL 将类似于

/workout-plans/1/beginner/
/workout-plans/beginner/1/
/workout-plans/beginner-1/

或者类似的东西。

我更喜欢最后一个，因为它并不表示完整列表和详细路径之间存在层次；如果您选择第一个，那么如果有人询问 /workout-plans/1/ 该怎么办。