rest - 为用户管理定义 REST 端点的正确方法

Question

我有一个典型的用户管理模块，我想为其创建 REST API。用户应该能够访问他/她的详细信息，但不应被允许访问其他用户详细信息。作为管理员用户应该能够获取任何用户或删除任何用户。

这就是我计划创建 URL 端点的方式，有什么建议吗？

# To create/register user
POST /api/users/
# or
POST /api/register/

# To get all users
# This will be allowed to access only by admins.
GET /api/users/

# To get current user.
# For admin, allowed
# For regular user, id will be validated against userid stored in the session.
GET /api/users/<id>/

# To update current user.
# This id will be validated against userid stored in the session.
PUT /api/users/<id>/

# To delete current user.
# For admin, allowed
# This id will be validated against userid stored in the session.
DELETE /api/users/<id>/

# Login
POST /api/login/

# Logout
GET /api/logout/

谢谢

Answer 1

我认为您的端点方案非常好..唯一的问题是上下文将是传入的用户(来自 url 路径)而不是当前用户。

# To create
POST /api/users

# To get all users
GET /api/users

# To get particular user.
GET /api/users/<id>

# To update particular user.
PUT /api/users/<id>

# To delete particular user
DELETE /api/users/<id>