34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
|
# FTS REST API
|
|||
|
|
|
|||
|
|
文件上传与文件服务配置。基础路径：`/rest/fts`。
|
|||
|
|
|
|||
|
|
## 路由
|
|||
|
|
|
|||
|
|
| 方法 | 路径 | 鉴权 | 请求 | 说明 |
|
|||
|
|
|---|---|---|---|---|
|
|||
|
|
| GET | `/rest/fts/ping` | 否 | 无 | 健康检查，返回 Pong |
|
|||
|
|
| GET | `/rest/fts/config` | 否 | 无 | 获取上传字段、大小和扩展名限制 |
|
|||
|
|
| POST | `/rest/fts/uploader` | Bearer Token | `multipart/form-data` | 上传文件到 local 或 MinIO |
|
|||
|
|
|
|||
|
|
## 上传文件
|
|||
|
|
|
|||
|
|
```http
|
|||
|
|
POST /rest/fts/uploader
|
|||
|
|
Authorization: Bearer <token>
|
|||
|
|
Content-Type: multipart/form-data
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
| 表单字段 | 类型 | 必填 | 说明 |
|
|||
|
|
|---|---|---:|---|
|
|||
|
|
| `provider` | string | 是 | `local` 或 `minio`，服务端转为小写 |
|
|||
|
|
| `bucket` | string | 是 | 存储桶或本地目录分类，服务端转为小写 |
|
|||
|
|
| `file` | file | 是 | 默认字段名；实际由配置 `Fts.FtsConfig.InputKey` 决定 |
|
|||
|
|
|
|||
|
|
服务端校验文件大小和扩展名，计算 SHA-256，并保存文件记录。默认开发配置最大 5 GiB，允许的扩展名见 `/rest/fts/config`。
|
|||
|
|
|
|||
|
|
成功数据为文件记录，常用字段：`identity`、`name`、`ext`、`size`、`hash`、`status` 以及最终访问地址。响应使用项目统一结构：
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{"code":0,"message":"success","data":{}}
|
|||
|
|
```
|