api - API 路径应该使用复数名词而不是单数名词，有什么理由吗？

Question

只是好奇，但我正在制作一个 API 并且到目前为止一直使用这样的 URL:

/用户/创建

/用户/[id]

现在我要添加

/用户/创建/批处理

这让我想知道是否有充分的理由称用户管理端点为“用户”而不仅仅是“用户”。话又说回来，也许这根本不重要。我想至少我应该在这方面保持一致。

想法？

Answer 1

我几乎总是在我的 url 设计中使用复数形式。我总是想在我的 url 路径中导航，类似于目录，在那里我越来越深入。

有一个顶级资源(如/users)表示一个集合，还有子资源(如/users/{userId}/items)本身是一个集合。

到目前为止我看到的所有 api 及其代表域都符合上述建议。

关于你提到的 /users/create/batch 看起来你想在 url 中编码一个“ Action ”。在基于 HTTP 的 Restful 设计中，如果您使用 HTTP 方法 POST/users(单用户有效负载)或用于传输多个用户的批量创建模式，它会更适合。在您的案例中，“创建”和“批处理”是什么意思？