Initial Dever 0.0.1

lib/doc/dever-api.md

@@ -0,0 +1,19 @@
+# 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`：请求过多