错误码
查阅 gResultCode 的分组与使用约定。
稳定错误码定义在 src/errors.ts。0 永远表示成功,负数按领域分组:
| 范围 | 领域 |
|---|---|
-1 至 -99 | 通用错误 |
-100 至 -199 | 网络 |
-200 至 -299 | 基础设施 |
-300 至 -399 | 邮件 |
-1000 至 -1199 | 用户认证与账户 |
-2000 至 -2099 | 限流与风险控制 |
-3000 至 -3299 | OAuth 客户端与 OAuth 2.0 服务器 |
-4000 至 -4099 | SaaS 配置与运行错误 |
-5000 至 -5099 | 支付 |
-6000 至 -6099 | 账户设置与安全操作 |
-7000 至 -7099 | 工单 |
-8000 至 -8099 | 列表查询 |
-9000 至 -9099 | 访问统计 |
-10000 至 -10099 | 模板发布 |
-11000 至 -11099 | Newsletter |
-12000 至 -12099 | 联盟推广 |
-13000 至 -13099 | 站内通知 |
这里列出的是源码中的错误码分组,不代表每个分组都对应已开放的 API。例如保留模板发布错误码,并不意味着初始化项目已经提供模板分发接口。
错误码表达机器可判断的原因,HTTP 状态码表达传输结果,本地化 error 键负责用户文案。三者不能互相替代。新增错误码时只能追加,不能复用已经发布的数值表达另一种含义。