有限收集的 HTTP 状态代码？

Question

我有一个安静的服务，其中一个集合是有限的（出于用户体验的原因）。在这种情况下，它有 25 个项目的上限。如果超过，则必须先删除资源，然后才能添加更多资源。例如，如果客户提交：

POST http://somesite.com/api/v2/stuff
{"cool":"stuff"}

东西里有

200 OK

如果有 > 25 个东西：

???

DELETE http://somesite.com/api/v2/stuff/:id

POST http://somesite.com/api/v2/stuff
{"cool":"stuff"}

200 OK

什么是最好的代码？直400？ 409冲突？ 429？没有一个似乎完全正确..

Answer 1

使用 409。来自httpbis section 7.5.8：

"由于与当前的冲突，请求无法完成 资源的状态。仅在以下情况下才允许使用此代码 预计用户可能能够解决冲突，并且 重新提交请求。有效载荷应该包含足够的信息 以便用户识别冲突的来源。”

在您的情况下，资源是由http://somesite.com/api/v2/stuff 标识的资源，并且POST 请求由于与其当前状态冲突（即它已经被最大化）而无法完成。在您的回复中，为用户提供足够的信息（最好是链接）以删除现有成员之一、超出限制或采取其他措施。然后他们可以重新提交原始请求。