超级会员免费看
本文探讨了HTTP协议中的错误码分类，并介绍了如何制定业务级别的错误码。讨论了错误码的格式，出参格式的选择，以及国际化的实现。通过支付宝和微信的案例，展示了错误码在实际接口设计中的应用，强调了错误码在接口文档中的重要性，以及在提供用户错误信息时应避免暴露底层细节。
HTTP 的业务错误码
Http 定义了 5大类别的错误码，这些错误码是通用的，其中只有 5XX 是表示后台服务的错误。各个系统的后端服务的用途/业务相差甚远，为数不多 5XX 远远不够用来表示可能出现的各种情况。于是，后端系统需要根据自己的业务制定业务级别的错误码，而 Http 的错误码，我们称其为协议级别的错误码。
1. 业务码格式
业务码不属于 Http 协议的成员，是实践中的产物。它是定义在返回的消息实体中的，并没有固定的格式，但无非就是下面3种模块。
【错误级别（可选）】-【功能模块（必要）】-【具体错误编号（必要）】
错误码一般由 5～6 位整数组成，例子如下：
| 模块 | 模块编码 | 错误编码 | 描述 |
|---|---|---|---|
| 库存 | 100 | 01 | 库存不足 |
| 库存 | 100 | 02 | 盘盈 |
| 库存 | 100 | 02 | 盘亏 |
| 资金 | 200 | 01 | 参数不正确 |
订阅专栏 解锁全文
1355
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
