在 REST API 中组织资源 (URI)

Question

场景 1
在我的 Web 应用程序中，说有一个用于将员工添加到系统的屏幕。一旦用户输入员工姓名后，它会根据一些逻辑自动生成员工代码（即下一个字段），并且已经存在数据库中的记录。

现在我想公开这个应用程序的 REST API，以便第三方开发人员可以在它之上构建。因此，我将有一个名为 /Employee 的资源，它将响应 GET、PUT 和 DELETE 动词。但是当客户端需要自动填充代码时，这是一个 GET 操作，它将在什么资源上？我应该创建一个新资源/EmployeeCodeFor/{Name} 还是应该在/Employee/{Name}/GenerateCode 上获得它？如果我使用/Employee/{Name}/GenerateCode，那么我的资源如何获取、放置和删除Employee，即实际上是/Employee/{Id}？

场景 2
在这里，让我们以 stackoverflow 帖子为例。所以可以说资源是/Post/{Id}。与前面的示例一样，只要我跳出Title 字段，它就会列出可能的重复问题。

我应该再次在哪个 URL 上获得那些可能的重复项？

我现在想不出更多的场景。但是在现实生活中的应用程序开发中可能会出现很多这样的场景。如何以 RESTful 方式实现它们？

方案 1 的更新
Code 和 Id 是两个不同的字段。 id是主键，代码可以跨部门重复，只是为了说明。同样要生成代码，应首先提供名称。因此，如果用户键入名称“FirstName LastName”，则服务器可能会生成 FL003 作为代码，假设在所述部门中已经有两个员工的名字从 F 开始，姓从 L 开始。可以根据登录用户识别部门。

Answer 1

让服务器有机会在新资源中预填充一堆元素的一种方法是这样做

POST /Employees
{with empty body}
=>
201 Created
Location: http://example.org/employee/3443

<Employee Id="3443">
   <Code>E1001</Code>
   <FirstName></FirstName>
   <LastName></LastName>
</Employee>

这使服务器有机会提供默认值。如果您正在寻找一种更具交互性的方式让服务器在输入期间提供反馈，我有另一种方法，但需要更多解释。

Answer 2

场景 1

假设您的员工代码是唯一标识符。在这种情况下，要获得它，您将允许用户填写新员工的任何字段，然后进行 POST。服务器将生成代码并使用指向 /Employee/{generated_code} 的链接响应 POST，这是您新创建的员工的记录。

/Employee 上的 GET 将返回所有员工的列表。 /Employee/{a_code} 上的 GET 将为您提供员工详细信息。

场景 2

您可以对/Post 集合进行某种查询，例如/Post?title_like={question_title}。 GET /Post?title_like=REST How to 会返回一个包含“REST How to”的所有问题的列表。