如果需要两个版本的资源，正确的命名API uri（RESTful）的方法是什么

Question

当我需要获取多个版本的资源时，我正在努力以正确的方式命名API。让我举个例子：

GET: /api/workers/

我想象上面将返回所有具有所有属性（身份证，姓名，生日，国籍等）的工人

但是，我可以为需要的系统成像：

1. 减少详细数据（仅工作量'id'和'name'）来填充组合框。
2. 更详细的数据，例如工人以及他们的孩子数或下一个预定的假期。

我进行了研究，但没有找到有关上述问题的博客/文章。

我想做的事情是这样的：

1. GET: /api/workers/basic
2. GET: /api/workres/detailed

但我直觉这种方法行不通，因为人们可以想象'基本'数据的更多变体（仅id和name或id，{{ 1}}和name），以及'detailed'的更多变化形式（带有age，带有children，带有holidays，以及所有可能的相关数据，等等） / p>