89 lines
1.5 KiB
Markdown
89 lines
1.5 KiB
Markdown
|
# 后端接口 TODO 清单 - 评论功能模块
|
|||
|
|
|
|||
|
|
## 1. 获取作品评论列表
|
|||
|
|
**文件**: `WorkDetailActivity.java`
|
|||
|
|
**接口路径**: `GET /api/works/{workId}/comments`
|
|||
|
|
**请求参数**:
|
|||
|
|
- workId: 作品ID（路径参数）
|
|||
|
|
- page (可选): 页码
|
|||
|
|
- pageSize (可选): 每页数量，默认20
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": [
|
|||
|
|
{
|
|||
|
|
"commentId": "string",
|
|||
|
|
"userId": "string",
|
|||
|
|
"username": "string",
|
|||
|
|
"avatarUrl": "string",
|
|||
|
|
"content": "string",
|
|||
|
|
"likeCount": "number",
|
|||
|
|
"createTime": "number"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 2. 发表评论
|
|||
|
|
**文件**: `WorkDetailActivity.java`
|
|||
|
|
**接口路径**: `POST /api/works/{workId}/comments`
|
|||
|
|
**请求参数**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"workId": "string",
|
|||
|
|
"content": "string",
|
|||
|
|
"userId": "string"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"commentId": "string",
|
|||
|
|
"userId": "string",
|
|||
|
|
"username": "string",
|
|||
|
|
"avatarUrl": "string",
|
|||
|
|
"content": "string",
|
|||
|
|
"likeCount": 0,
|
|||
|
|
"createTime": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 删除评论
|
|||
|
|
**文件**: `WorkDetailActivity.java`
|
|||
|
|
**接口路径**: `DELETE /api/comments/{commentId}`
|
|||
|
|
**请求参数**: commentId (路径参数)
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"success": true
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 4. 点赞评论
|
|||
|
|
**文件**: `WorkDetailActivity.java`
|
|||
|
|
**接口路径**: `POST /api/comments/{commentId}/like`
|
|||
|
|
**请求参数**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"commentId": "string",
|
|||
|
|
"action": "like|unlike"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"success": true,
|
|||
|
|
"likeCount": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|