BlueArchiveToolkit/docs/api

API 文档

本目录包含 BlueArchive Toolkit 的 API 文档。

当前 API Server 尚未实现，本文件只记录规划边界，不代表已有可运行 HTTP 服务或 OpenAPI 产物。

OpenAPI 规范

OpenAPI 文档将在 API Server 落地后生成，目标使用 OpenAPI 3.0 标准。当前仓库尚未提供 openapi/ 生成产物。

文档生成

API 文档将在开发过程中自动生成和更新。

计划：

• 使用 swag (Go) 从代码注释生成 OpenAPI 文档
• 提供 Swagger UI 在线查看
• 支持导出为 Markdown、HTML 等格式

---

核心 API 端点（规划中）

认证

• POST /api/v1/auth/login - 用户登录
• POST /api/v1/auth/logout - 用户登出
• POST /api/v1/auth/refresh - 刷新 Token

翻译管理

• GET /api/v1/translations - 获取翻译列表
• POST /api/v1/translations - 创建翻译
• PUT /api/v1/translations/:id - 更新翻译
• DELETE /api/v1/translations/:id - 删除翻译

术语管理

• GET /api/v1/glossary - 获取术语列表
• POST /api/v1/glossary - 创建术语
• PUT /api/v1/glossary/:id - 更新术语
• DELETE /api/v1/glossary/:id - 删除术语

资源同步

• POST /api/v1/sync/start - 启动同步
• GET /api/v1/sync/status - 查询同步状态
• POST /api/v1/sync/cancel - 取消同步

---

更多详细文档将在 API Server 实现后补充。