core/lib/doc/dever-api.md

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：请求过多