rest - 失败的 post 请求的 api 状态代码

Question

我有一个 post API 调用，当前在我的预订系统中创建了一个约会。

如果 api 调用发送约会请求并且 api 可以成功创建约会，则 api 返回 201 created 状态代码。

目前，如果约会请求未创建(由于各种原因，例如时间不再可用或房间正在使用中)，api 将返回 400 错误请求状态代码。

“400 Bad Request 响应状态代码表示服务器不能或不会处理请求，因为某些事情被认为是客户端错误”

发送的数据不是无效语法，可能会重新发送并成功。

创建资源失败是否有更相关的状态码。在这种情况下，422 Unprocessable Entity 会是一个有效的响应吗？

Answer 1

409 可能适合这种用例(以及我个人的偏好):

"The request could not be completed due to a conflict with the current state of the target resource. This code is used in situations where the user might be able to resolve the conflict and resubmit the request."

通常在 PUT 中使用，但可以在这种情况下使用。例如，他们可以更改请求中的建议时间。或者，如果房间可用，他们可以稍后重试。

422 也可以用于指示字段级错误。

无论哪种方式，重要的是要附上一条指示问题的正确错误消息。来自 rfc7231:

the server SHOULD send a representation containing an explanation of the error situation, and whether it is a temporary or permanent condition. These status codes are applicable to any request method.