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

Question

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

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

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

相对：

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

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

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

Answer 1

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

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