api 接口 http 响应码问题?

[Zach369]

2018 年 新项目 开始使用 restful 风格接口. 所有的返回 遵循 HTTP 响应码. 结果 很不理想,不管是 web 还是客户端,亦或者安卓和 ios. 都很反对这种开发模式. 但是楼主还是坚持了下来.

目前又有一个跟外包配合的项目. 外包那边提出 所有的接口 必须是 200.

返回格式必须是:

{
    "code": 0,        //0 位正常,其他则为异常.
    "result": "",
    "msg": "报错信息"
}

想问下 各位大佬现在是怎么使用的那?

[grzhan]

之前为公司制定过 HTTP API 标准，所以那时候看了不少其他公司的方案，不过多数是海外的公司，微软、Google、Github、Paypal、Zalendo 等等。
我想知道国内有哪些公司的公开 API 标准不管错误还是正确都是以 200 状态码返回的，有相关资料吗？

[11ssss]

首先说 http 状态码不是描述业务的 ,我同意.
其次表达个人观点, http 状态码本身就是描述服务状态的 看到有人说直接返回 4xx/5xx 是憨憨 或 xxx 的 我只想说 你有代码规范吗?你有技术追求吗? http 状态码才是规范的 通用以及最好对接的方式. 至于业务代码合理的使用方式是在你 4xx/5xx 的时候,包含在你的 payload 里的.

[bearxu]

必须是 200 的原因主要是 有段时间很多 isp 都会劫持大于 400 的响应插入广告
不过这年头都是 https 了，没那么容易劫持了吧？

[skiy]

网页状态码太少了，不足以表达所有的意思。

不过我现在是业务代码跟网页状态码组合起来用。我其实不喜欢只用网页状态

[vibbow]

200 + Code 的路过

[metrxqin]

刚巧前些时间发内部邮件讨论新的服务端响应代码格式，供大家参考：

[]( https://postimg.cc/zy1D91t6)

[arnoldxiao]

code=0 是正常，其他则异常

[katsusan]

国外大厂的设计风格：
https://developer.github.com/v3/
https://github.com/paypal/api-standards
https://cloud.google.com/apis/design //mainly grpc design
https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md
https://developer.twitter.com/en/docs/ads/general/guides/response-codes

[liuzhiyong]

既然“都很反对”，那就不要固执了。这东西灵活处理，没关系啦。

[Zach369]

感谢大家的意见.我最近琢磨了下... 我绝对灵活点.... 想怎么用就怎么用..