何时为同一资源加倍休息API路由？

Question

我需要Task和id访问state资源。我有两个选择来实现这个目标：

选项1：

创建2条路线：

• api/tasks/:id：返回一个元素
• api/tasks/:state：返回一个列表

选项2：

• 仅创建1个根：api/tasks/:id
• 从父资源中获取按州分类的任务ID列表：api/projects/:id

我正在开发SPA，需要知道哪个选项更干净？

Answer 1

您可以考虑以下事项：

• GET /api/tasks/{id}：返回具有给定标识符的任务的表示。如果没有任务与给定的ID匹配，则应返回404响应。
• GET /api/tasks?state={state}：返回具有与给定状态匹配的任务的集合的表示形式。如果没有任务与给定状态匹配，则应返回带有空数组的200响应。