Base:NEXT_PUBLIC_API_URL(本地 http://localhost:8000)。
鉴权:Authorization: Bearer <token>(登录 JWT 或设置页 sv_ 密钥)。
登录与注册见 登录与注册(POST /v1/auth/send-code、POST /v1/auth/register、POST /v1/auth/login、POST /v1/auth/reset-password)。
相关接口
| 文档 | 内容 |
|---|---|
| 登录与注册 | 发码、注册、登录、重置密码 |
| 空间(创建 / 列表 / 详情) | 创建、列表、详情、用量、更新 |
| 上传文件 | TUS、multipart、笔记、批量导入参考文献 |
| 文档(列表 / 读写) | 列表、正文、元数据、compile |
| 删除文档 / 空间 | 单篇 / 批量 / 整库 |
论文场景与接口:场景示例 · 论文相关接口(含选模板 + Markdown → PDF / Word / PPT)。
常见错误
错误响应一般为 JSON,例如 { "detail": "…" }(字符串或校验错误数组)。
| 码 | 含义 |
|---|---|
400 | 参数错误 |
401 | 未登录 / Token 无效 |
403 | 无权 |
404 | 不存在 |
409 | 冲突(如邮箱已注册、TUS 偏移、同步未就绪) |
413 | 超过 100 MB |
501 | 能力未配置(如存储) |
503 | 服务不可用(如名额已满、未配置整理密钥) |