错误码

查阅 gResultCode 的分组与使用约定。

稳定错误码定义在 src/errors.ts。0 永远表示成功,负数按领域分组:

范围领域
-1 至 -99通用错误
-100 至 -199网络
-200 至 -299基础设施
-300 至 -399邮件
-1000 至 -1199用户认证与账户
-2000 至 -2099限流与风险控制
-3000 至 -3299OAuth 客户端与 OAuth 2.0 服务器
-4000 至 -4099SaaS 配置与运行错误
-5000 至 -5099支付
-6000 至 -6099账户设置与安全操作
-7000 至 -7099工单
-8000 至 -8099列表查询
-9000 至 -9099访问统计
-10000 至 -10099模板发布
-11000 至 -11099Newsletter
-12000 至 -12099联盟推广
-13000 至 -13099站内通知

这里列出的是源码中的错误码分组,不代表每个分组都对应已开放的 API。例如保留模板发布错误码,并不意味着初始化项目已经提供模板分发接口。

错误码表达机器可判断的原因,HTTP 状态码表达传输结果,本地化 error 键负责用户文案。三者不能互相替代。新增错误码时只能追加,不能复用已经发布的数值表达另一种含义。