128 lines
2.8 KiB
Markdown
128 lines
2.8 KiB
Markdown
|
# 后端接口 TODO 清单 - 图片/视频上传模块
|
|||
|
|
|
|||
|
|
## 1. 上传作品图片
|
|||
|
|
**文件**: `PublishWorkActivity.java`
|
|||
|
|
**接口路径**: `POST /api/upload/work/image`
|
|||
|
|
**请求方法**: POST
|
|||
|
|
**请求类型**: multipart/form-data
|
|||
|
|
**请求参数**:
|
|||
|
|
- file: File (必填) - 图片文件
|
|||
|
|
- userId: String (可选，从token中获取)
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"url": "string",
|
|||
|
|
"fileId": "string"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 2. 上传作品视频
|
|||
|
|
**文件**: `PublishWorkActivity.java`
|
|||
|
|
**接口路径**: `POST /api/upload/work/video`
|
|||
|
|
**请求方法**: POST
|
|||
|
|
**请求类型**: multipart/form-data
|
|||
|
|
**请求参数**:
|
|||
|
|
- file: File (必填) - 视频文件
|
|||
|
|
- userId: String (可选，从token中获取)
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"url": "string",
|
|||
|
|
"fileId": "string",
|
|||
|
|
"duration": "number",
|
|||
|
|
"thumbnailUrl": "string"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 上传头像
|
|||
|
|
**文件**: `EditProfileActivity.java`
|
|||
|
|
**接口路径**: `POST /api/upload/avatar`
|
|||
|
|
**请求方法**: POST
|
|||
|
|
**请求类型**: multipart/form-data
|
|||
|
|
**请求参数**:
|
|||
|
|
- file: File (必填) - 头像图片文件
|
|||
|
|
- userId: String (可选，从token中获取)
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"url": "string",
|
|||
|
|
"fileId": "string"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 4. 上传聊天图片
|
|||
|
|
**文件**: `MessageSendHelper.java`, `ConversationActivity.java`
|
|||
|
|
**接口路径**: `POST /api/upload/chat/image`
|
|||
|
|
**请求方法**: POST
|
|||
|
|
**请求类型**: multipart/form-data
|
|||
|
|
**请求参数**:
|
|||
|
|
- file: File (必填) - 图片文件
|
|||
|
|
- conversationId: String (必填) - 会话ID
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"url": "string",
|
|||
|
|
"fileId": "string",
|
|||
|
|
"thumbnailUrl": "string"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 5. 上传语音消息
|
|||
|
|
**文件**: `MessageSendHelper.java`, `ConversationActivity.java`
|
|||
|
|
**接口路径**: `POST /api/upload/chat/voice`
|
|||
|
|
**请求方法**: POST
|
|||
|
|
**请求类型**: multipart/form-data
|
|||
|
|
**请求参数**:
|
|||
|
|
- file: File (必填) - 语音文件
|
|||
|
|
- conversationId: String (必填) - 会话ID
|
|||
|
|
- duration: Number (必填) - 语音时长（秒）
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"url": "string",
|
|||
|
|
"fileId": "string",
|
|||
|
|
"duration": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 通用说明
|
|||
|
|
|
|||
|
|
### 文件大小限制
|
|||
|
|
- 头像图片: 最大 5MB
|
|||
|
|
- 作品图片: 最大 10MB
|
|||
|
|
- 作品视频: 最大 500MB
|
|||
|
|
- 聊天图片: 最大 10MB
|
|||
|
|
- 语音消息: 最大 10MB
|
|||
|
|
|
|||
|
|
### 支持的文件格式
|
|||
|
|
- 图片: JPG, PNG, GIF, WEBP
|
|||
|
|
- 视频: MP4, MOV, AVI
|
|||
|
|
- 语音: MP3, AAC, M4A
|
|||
|
|
|
|||
|
|
### 上传流程建议
|
|||
|
|
1. 前端压缩图片（可选，节省流量）
|
|||
|
|
2. 显示上传进度
|
|||
|
|
3. 上传成功后获取URL
|
|||
|
|
4. 将URL保存到对应的数据对象中
|
|||
|
|
5. 调用相应的创建/更新接口
|
|||
|
|
|
|||
|
|
### 错误处理
|
|||
|
|
- 文件过大: 返回 413 错误
|
|||
|
|
- 文件格式不支持: 返回 415 错误
|
|||
|
|
- 上传失败: 返回 500 错误，允许重试
|