关于设计 REST API 以返回可能的嵌套资源的问题

Question

我有一个名为 Checklist 的资源控制器。清单可以有多个用户权限。 UserRight 包含 ChecklistGuid、UserGuid 和 AccessModifier（读/写）。

我有以下路线来使用 UserRights：

GET /api/Checklist/{ChecklistGuid}/UserRight

PUT /api/Checklist/{ChecklistGuid}/UserRight

DELETE /api/Checklist/{ChecklistGuid}/UserRight

我的问题是：返回所有尚未分配给特定清单的用户的路线会是什么样子？

我添加了另一条路线“.../UserRight/UsersNotAssigned”，但我不喜欢这种方式。

Answer 1

我认为 /api/unassignedUsers 是合适的，因为通常通过查看资源路径，我们必须了解我们得到的结果。