97 lines
1.6 KiB
Markdown
97 lines
1.6 KiB
Markdown
# 文件上传 API
|
||
|
||
## 基础信息
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 基础URL | `http://localhost:8082` |
|
||
| 上传模式 | local / minio（配置决定） |
|
||
|
||
## 配置说明
|
||
|
||
```yaml
|
||
# config.yaml
|
||
upload_mode: "local" # 上传模式：local 或 minio
|
||
upload_local_path: "resource/files" # 本地存储路径
|
||
server_base_url: "http://localhost:8082" # 服务器基础URL
|
||
|
||
# MinIO 配置（upload_mode 为 minio 时需要）
|
||
minio_endpoint: "localhost:9000"
|
||
minio_access_key: "your-access-key"
|
||
minio_secret_key: "your-secret-key"
|
||
minio_bucket: "x-agents"
|
||
minio_use_ssl: false
|
||
```
|
||
|
||
## 接口列表
|
||
|
||
### 1. 上传文件
|
||
|
||
**请求**
|
||
|
||
```
|
||
POST /api/file_upload
|
||
Content-Type: multipart/form-data
|
||
```
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|------|------|------|------|
|
||
| file | File | 是 | 要上传的文件 |
|
||
|
||
**响应**
|
||
|
||
```json
|
||
{
|
||
"success": true,
|
||
"url": "http://localhost:8082/files/abc123.pdf",
|
||
"fileKey": "abc123",
|
||
"message": "Upload successful"
|
||
}
|
||
```
|
||
|
||
**错误响应**
|
||
|
||
```json
|
||
{
|
||
"success": false,
|
||
"message": "File too large (max 100MB)"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 2. 删除文件
|
||
|
||
**请求**
|
||
|
||
```
|
||
DELETE /api/file_upload/:filename
|
||
```
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|------|------|------|------|
|
||
| filename | String | 是 | 文件名（不含路径） |
|
||
|
||
**响应**
|
||
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "File deleted"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 3. 访问文件（仅本地模式）
|
||
|
||
文件上传后，本地模式下可通过以下 URL 直接访问：
|
||
|
||
```
|
||
GET /files/{filename}
|
||
```
|
||
|
||
例如：`http://localhost:8082/files/abc123.pdf`
|
||
|
||
> 注意：MinIO 模式返回的是预签名 URL，有效期 24 小时。
|