node.js - API 命名推荐 - findById findByName

Question

我正在创建一个新的 API 并研究一些好的 API 命名约定。

例如，您有一个如下 API:

GET - /users           | Get all users
GET - /users/:id       | Get user with :id
DELETE - /users/:id    | Delete user with :id
POST - /users          | Create a new user

现在我想添加一条用于按名称获取用户的路由，以实现前端自动完成/提前输入组件的后端路由。

有什么好的命名建议吗？

你觉得怎么样:

GET - /users/name/:name       | Get user with :name

Answer 1

由于您基本上只是过滤用户，因此您应该使用查询参数来传递任何过滤器

/users?name=xxx&other=xxx

这将使您保持路由干净，并允许您将来传递多个参数