我是否需要为每个用户角色编写单独的 API 端点？

Question

我的应用中有两个不同角色的用户，学生和管理员。每个用户都有一个 team_id 字段引用，它告诉用户它属于哪个团队。在这种情况下，我的数据库由这些表组成：用户、团队。

为了显示团队详细信息，我有一个如下 API： 获取：api/teams/{team_id}

public function show($id)
    {
        $team = $this->teamService->findById($id);
        if ($team) {
            return response()->json(['message' => 'Success', 'success' => true, 'status' => 200, 'data' => $team]);
        } else {
            return response()->json(['message' => 'Error', 'success' => true, 'status' => 404, 'data' => null]);
        }
    }

这仅适用于管理员，因为 $id 作为参数传递到 url，这意味着只有管理员可以输入任何 $id，而普通用户必须根据他们所属的团队自动关联 id（所以在这种情况下，我想显示他们所属团队的团队详细信息）。

所以在这种情况下，我的 api 应该如下所示： 获取：api/团队

public function show()
        {
            $team = $this->teamService->findById(Auth->user->team_id); //associate the team id for user logged in
            if ($team) {
                return response()->json(['message' => 'Success', 'success' => true, 'status' => 200, 'data' => $team]);
            } else {
                return response()->json(['message' => 'Error', 'success' => true, 'status' => 404, 'data' => null]);
            }
        }

所以我的最后一个问题是，有没有什么办法可以将这两个角色放在一个地方.. 这样就不会有不同角色的重复功能。

在这种情况下，API 应该是什么样子？

谢谢

Answer 1

我需要为每个用户角色编写单独的 API 端点吗？

不，绝对不是。

在这种情况下，API 应该是什么样子？

没有“正确”的答案，但这里有两个想法：

1) 用户对象应该有指向您的团队对象的链接：

{ name: "bob", team_link: "/team/3" }

然后你的/team/:id 路由应该检查“如果你不是管理员用户，如果用户不在这个团队中，则给出 404。”

2) 如果您真的认为用户需要获取他们自己的团队信息，您可以使用/team 路由。但以上更标准。或者，提供指向真实团队对象的链接。 （为什么？因为它使缓存变得更容易。）