# OpenCloud API 文档入口

当前前端接入 Hono 后端 `hono-api`，默认 API 根地址为 `http://localhost:3000`。

- 前端分层、Cookie 认证、分页和契约同步：[通信架构](docs/api-architecture.md)。
- 完整端点、请求字段、权限与迁移表：相邻后端仓库的 [API.md](../hono-api/API.md)。
- 前端使用的生成契约：[api-contract.ts](src/types/api-contract.ts)。

前端不再维护后端手册的副本。修改后端 schema 后先生成契约，再执行 `npm run api:sync` 和 `npm run api:check`；前后端配套检查通过后一起发布。本次资源路径、字段名与分页格式有破坏性变化，迁移明细以当前后端文档为准。