php - 关于API 使用 HTTP 状态码还是全部返回 200

Question

现在的项目api想用restful风格，然后目前的api接口返回规范：所有成功接口返回{status:200,msg:'',data:{}}，出错接口返回{status:403,msg:'',data:{}},也就是只有200和403两种状态，我感觉不太对劲，搜了下网上...

巴扎黑 · Answer

有两种方法
1.status_code全部200，响应体如下：
成功

{
  errcode: 0,
  errmsg: null,
  data: obj // 数据主体
}

失败

{
  errcode: 1, // 具体错误代码
  errmsg: '账号错误',
}

2.根据不同的status_code处理（推荐）
成功(2xx)，直接返回数据，不用额外包装

[]// 或者{}

失败(4xx,5xx),返回errcode和errmsg

{
  errcode: 1,
  errmsg: '账号或密码错误',
}

PHP中文网 · Answer

{status:200,msg:'',data:{}} 这个应该是你API里自己写的返回结果吧，比如servlet里返回一个json字符串包含这3个字段。也就是说只有你的api返回成功时前端才能读到这些信息。如果请求失败是读不到的，你可以前端请求一个错误的url试试看

某草草 · Answer

其实如果规范的话应该是要这么返回的
header('HTTP/1.0 401 Unauthorized');
header('HTTP/1.0 403 Forbidden');

不过实际情况下，很多人不会这么规范。
连GET请求和POST请求都在混用，何谈规范呢

怪我咯 · Answer

本来是应该按规范来的，但是国内电信运营商可能会劫持跳转。比如你返回 404，运营商可能给你跳到他们自己的导航网站，那就尴尬了。

过去多啦不再A梦 · Answer

你的接口返回数据和http响应是两个东西

接口返回的code是内定的想怎么定就怎么定

而你查的资料那是http响应的状态码和你接口返回无关

習慣沉默 · Answer

业务错误代码 4xx
成功200 - 204
系统错误 5xx