URL / API 架构最佳实践

Question

我经常遇到这个问题，不知道什么是最好的做法。 所以，例如我想要我的角度应用程序的三个端点：

1. 列出我的所有患者页面
2. 创建患者页面
3. 患者的详细页面

我的大脑建议如下：

1. /患者
2. /患者/添加
3. /患者/{id}

似乎有点不对劲，因为 2. 和 3. 可能会导致问题？好的，id 永远不会是'add'，特别是如果 id 是整数。

API 几乎相同。但是我们有 POST、PUT 等。 所以这个例子有点像：

1. /api/measurement/dashboard -> 所有用户（计数、组等）的所有测量的汇总信息
2. /api/measurement/{user} -> 关于特定用户测量的聚合信息 （没关系，我猜位测量包含 HR、体重等数据。）

这样创建端点很常见吗？这是一个好的还是好的 enoguht 实践？

Answer 1

从我的角度来看

GET /patient
PUT /patient
POST /patient
GET /patient/{id} 

看起来不错。

第二部分

GET /api/measurement
GET /api/measurement?user={userId}&group={groupId} 

如果我正确理解上下文，应该适用于你的情况。