API响应状态代码的最佳实践

时间:2016-11-20 20:24:45

标签: http httprequest http-status-codes api-design

我正在构建API,我将为每种方法返回此类状态代码(例如," register_user"):

    用户注册成功后
  • 200(确定)
  • 403(禁止)请求中缺少参数
  • 用户已注册
  • 409(冲突)

除了状态代码,我还会返回一条"消息"现场解释发生了什么。你认为在这个例子中返回这些代码是一个好习惯吗?或者我应该在所有这些中返回200但是"消息中的错误"场?

1 个答案:

答案 0 :(得分:0)

  

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

- RFC 7231, 6.5.3

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