API响应状态代码的最佳做法

Question

我正在构建一个API，并为每种方法返回这种状态代码（例如“ register_user”）：

• 成功注册用户后，显示200 （确定）
• 403 （禁止），当请求中缺少参数时
• 当用户已经注册时的409 （冲突）

除了状态码之外，我还返回一个“消息”字段来说明发生了什么。 您是否认为在此示例中返回这些代码是一种好习惯？ 还是我应该全部返回200，但“消息”字段中有错误？

Answer 1

403（禁止）状态码表示服务器理解了请求，但拒绝授权。 希望公开为什么禁止请求的服务器可以在响应有效负载（如果有）中描述该原因。

-RFC 7231，6.5.3

这听起来根本不像您所拥有的。 另外两个是合理的。 缺少的参数通常使用400响应代码处理。