97 lines
2.0 KiB
Markdown
97 lines
2.0 KiB
Markdown
|
# API 契约：资料管理
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## POST /api/source/upload
|
|||
|
|
|
|||
|
|
**权限**: UPLOADER
|
|||
|
|
**描述**: 上传文件，创建 source_data 记录，文件字节流写入 RustFS
|
|||
|
|
|
|||
|
|
**请求**: `multipart/form-data`，字段：`file`（必填）、`dataType`（TEXT / IMAGE / VIDEO）
|
|||
|
|
|
|||
|
|
**响应** `201`:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": "SUCCESS",
|
|||
|
|
"data": {
|
|||
|
|
"id": 50,
|
|||
|
|
"fileName": "document.txt",
|
|||
|
|
"dataType": "TEXT",
|
|||
|
|
"fileSize": 204800,
|
|||
|
|
"status": "PENDING",
|
|||
|
|
"createdAt": "2026-04-09T10:00:00"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**失败**:
|
|||
|
|
- `400` `INVALID_TYPE`: 不支持的资料类型
|
|||
|
|
- `400` `FILE_EMPTY`: 文件为空
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## GET /api/source/list
|
|||
|
|
|
|||
|
|
**权限**: UPLOADER
|
|||
|
|
**描述**: 分页查询资料列表。UPLOADER 只见自己上传的资料；ADMIN 见本公司全部资料
|
|||
|
|
|
|||
|
|
**查询参数**: `page`（默认 1）、`pageSize`（默认 20）、`dataType`（可选）、`status`（可选）
|
|||
|
|
|
|||
|
|
**响应** `200`:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": "SUCCESS",
|
|||
|
|
"data": {
|
|||
|
|
"items": [
|
|||
|
|
{
|
|||
|
|
"id": 50,
|
|||
|
|
"fileName": "document.txt",
|
|||
|
|
"dataType": "TEXT",
|
|||
|
|
"status": "PENDING",
|
|||
|
|
"uploaderId": 1,
|
|||
|
|
"createdAt": "2026-04-09T10:00:00"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"total": 120,
|
|||
|
|
"page": 1,
|
|||
|
|
"pageSize": 20
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## GET /api/source/{id}
|
|||
|
|
|
|||
|
|
**权限**: UPLOADER
|
|||
|
|
**描述**: 查看资料详情，含 RustFS 预签名临时下载链接（有效期 15 分钟）
|
|||
|
|
|
|||
|
|
**响应** `200`:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": "SUCCESS",
|
|||
|
|
"data": {
|
|||
|
|
"id": 50,
|
|||
|
|
"dataType": "TEXT",
|
|||
|
|
"fileName": "document.txt",
|
|||
|
|
"fileSize": 204800,
|
|||
|
|
"status": "EXTRACTING",
|
|||
|
|
"presignedUrl": "https://rustfs.example.com/...",
|
|||
|
|
"parentSourceId": null,
|
|||
|
|
"createdAt": "2026-04-09T10:00:00"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## DELETE /api/source/{id}
|
|||
|
|
|
|||
|
|
**权限**: ADMIN
|
|||
|
|
**描述**: 删除资料（同时删除 RustFS 文件及元数据）
|
|||
|
|
|
|||
|
|
**前置条件**: 资料状态为 PENDING（不允许删除已进入流水线的资料）
|
|||
|
|
|
|||
|
|
**响应** `204`: 无响应体
|
|||
|
|
**失败**: `409` `SOURCE_IN_PIPELINE`: 资料已进入标注流程，不可删除
|