项目、标签与分享

文件库是资源真值；项目、标签和搜索是资源的组织视图。调用方应保留文件或文档 ID，不用名称代替稳定标识。

项目

GET    /api/v1/projects
POST   /api/v1/projects
GET    /api/v1/projects/{project_id}
PATCH  /api/v1/projects/{project_id}
DELETE /api/v1/projects/{project_id}

POST   /api/v1/projects/{project_id}/documents
DELETE /api/v1/projects/{project_id}/documents/{document_id}

把文档加入项目只改变组织关系，不复制文件，也不改变文档所有者。

标签

GET    /api/v1/tags
POST   /api/v1/tags
DELETE /api/v1/tags/{tag_id}

POST   /api/v1/tags/documents/{document_id}
DELETE /api/v1/tags/documents/{document_id}/{tag_id}

标签名是展示内容；删除、解绑和查询使用标签 ID。

搜索

GET /api/v1/search?q={query}&limit=20

搜索结果只返回当前账号有权读取的文档和任务。搜索是读操作，不扣积分。

分享链接

GET    /api/v1/shares
POST   /api/v1/shares
GET    /api/v1/shares/{token}
GET    /api/v1/shares/{token}/download
DELETE /api/v1/shares/{token}

POST /shares 为翻译结果创建只读链接，请求体为 artifact_id 和可选的 expires_in_days（1–365，不传则长期有效）。持有链接即可下载，请勿写入日志或分析参数，不再需要时删除。

应用工作区

GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

这组接口用于构建 OmniDoc 账号下的统一工作台。客户端应以响应中的入口和能力为准，不自行拼接应用 URL。