响应等量HTTP POST请求

RESTfulAPI的一部分将允许用户使用序列号注册项目。由于序列号不是全局唯一的,它不能用作资源的标识符,因此我们将使用到父资源的post来生成标识符,例如。

POST /my/items

<item serial-number="ABCDEF" />

在项目尚未注册的情况下,HTTP语义定义良好。我们返回一个位置标题,并将注册项作为实体体,例如

HTTP 201 Created
Location: /my/items/1234    

<item id="1234" serial-number="ABCDEF" />

但是,如果该项已经注册,则API应该是等幂的,返回以前注册的项,而不创建新的项。我的最佳猜测是,然后它应该返回一个200 OK状态代码,并使用Content-location头来指示项目的实际来源,例如。

HTTP 200 OK
Content-Location: /my/items/1234    

<item id="1234" serial-number="ABCDEF" />

这看起来合理吗?在第二种情况下,我不完全清楚位置或内容位置是否更适合。