RESTful API 设计 - /users/:userId/resourceType 与 /resourceType/?user=:userId

Question

我正在旋转我的轮胎，我很想知道其他人在相同情况下的决定。

要从 RESTful API 获取由:userId 标识的用户的resourceType 列表，如果我有资源可以这样处理，那么哪种 URI 模式最有意义：

/users/:userId/resourceType // 返回 :userId 的资源类型列表

对比：

/resourceType/?userId=:userID //查询resourceType列表

我一直在想“两者都做”——但考虑到复杂资源模型可能有多少排列，这感觉不切实际。

它只是“选择一个并继续”的场景，还是有一个在实用上比另一个更好，我只是没有看到它？

Answer 1

绝对不要两者都做！您只是在为自己提供支持。最好是 API 只提供一种方法来做一件事。

两者都可以。这取决于资源类型与用户的耦合程度。如果存在紧密耦合，则（1）很好。如果您不确定，或者它们只是松散耦合，那么 (2) 更可取。