20 lines
689 B
Markdown
20 lines
689 B
Markdown
# API 错误
|
|
|
|
Error 映射为固定 HTTP 状态；内部故障和敏感消息不进入响应。
|
|
|
|
## dever.api.require
|
|
|
|
条件为 true 时继续，false 时传播指定的 Error。用于已有业务条件的检查，不替代身份认证、对象权限、数据库约束或状态分支。不要在各领域重复定义仅负责 true/false 失败的一对函数。
|
|
|
|
## dever.api.Error
|
|
|
|
业务可以显式返回安全错误；其他失败统一返回内部错误。
|
|
|
|
分支：
|
|
- `error Invalid`：请求无效
|
|
- `error Unauthorized`：未认证
|
|
- `error Forbidden`：无权访问
|
|
- `error NotFound`：资源不存在
|
|
- `error Conflict`：资源冲突
|
|
- `error TooManyRequests`：请求过多
|