由于存在匹配资源而导致资源创建POST失败时的HTTP响应代码

Question

想象一下，我们有一个API，可以通过发布到

www.example.com/api/employees

员工可以被描述为：，

{
  name: "John Smith",
  tax_number: "ABC123"
}

税号对所有人类来说都是普遍唯一的。如果创建了一个记录，并且该记录已经存在，其中名称和税号与现有记录相匹配，那么可以安全地假设请求者希望返回对该记录的引用（包括其内部id和客户端可能没有的其他数据），创建于，更新于）。

返回该资源的HTTP状态码是什么？我想重定向可以只返回id，但我更愿意在响应中包含整个对象。

这种情况对于简单的复制错误来说是独一无二的，因为如果尝试复制，则意味着您希望创建的记录已经存在，而不是与现有记录冲突。

Answer 1

有一个409冲突响应代码，通常用于让客户端知道这样的实体已经存在于服务器上。解析错误响应的主体可能不是很直观，但是如果您在API留档中指定此项，应该不会有问题（将关于原始条目的信息放在响应主体中）。

Answer 2

我认为，如果您将资源发布到API，那么您需要一个代码201，该代码将声明该资源已创建，并且主体将（可以）包含该资源。否则，您首先必须检查资源是否已创建，但这将需要两个调用。

否则，您的状态代码为409：

由于与资源的当前状态冲突，无法完成请求。

[编辑]在阅读了阿蒙森、鲁比和理查森的Restfull Web API之后

最好是使用409状态代码，声明与服务器上存在的资源有冲突。将"冲突"资源的url放在响应的位置标题中，并在正文中添加冲突消息