0b28c9fa4c
- 重构API文档侧边栏，将公开API拆分为子分类（评论、点赞、配置、身份验证、访问统计） - 新增详细的公开API接口文档，包括评论管理、点赞功能、配置获取、身份验证和访问统计 - 完善数据统计功能文档，增加概览数据、访问明细和数据分析说明 - 更新功能设置文档，补充图片预览和个性化设置说明 - 修正管理员登录文档中的错误描述和格式问题
120 lines
1.7 KiB
Markdown
120 lines
1.7 KiB
Markdown
# 评论点赞
|
|
|
|
## 点赞评论
|
|
|
|
```
|
|
POST /api/comments/like
|
|
```
|
|
|
|
对指定评论进行点赞操作。
|
|
|
|
- 方法：`POST`
|
|
- 路径：`/api/comments/like`
|
|
- 鉴权：不需要
|
|
|
|
**请求头**
|
|
|
|
| 名称 | 必填 | 示例 |
|
|
| -------------- | ---- | ------------------ |
|
|
| `Content-Type` | 是 | `application/json` |
|
|
|
|
**请求体**
|
|
|
|
```json
|
|
{
|
|
"id": 123
|
|
}
|
|
```
|
|
|
|
字段说明：
|
|
|
|
| 字段名 | 类型 | 必填 | 说明 |
|
|
| ------ | ------ | ---- | ---------- |
|
|
| `id` | number | 是 | 评论 ID |
|
|
|
|
**成功响应**
|
|
|
|
- 状态码：`200`
|
|
|
|
```json
|
|
{
|
|
"message": "点赞成功",
|
|
"likes": 5
|
|
}
|
|
```
|
|
|
|
字段说明：
|
|
|
|
| 字段名 | 类型 | 说明 |
|
|
| ------- | ------ | -------------- |
|
|
| `likes` | number | 更新后的点赞数 |
|
|
|
|
**错误响应**
|
|
|
|
- 状态码：`400`
|
|
|
|
```json
|
|
{
|
|
"message": "评论不存在"
|
|
}
|
|
```
|
|
|
|
## 取消点赞评论
|
|
|
|
```
|
|
DELETE /api/comments/like
|
|
```
|
|
|
|
取消对指定评论的点赞。
|
|
|
|
- 方法：`DELETE`
|
|
- 路径：`/api/comments/like`
|
|
- 鉴权：不需要
|
|
|
|
**请求头**
|
|
|
|
| 名称 | 必填 | 示例 |
|
|
| -------------- | ---- | ------------------ |
|
|
| `Content-Type` | 是 | `application/json` |
|
|
|
|
**请求体**
|
|
|
|
```json
|
|
{
|
|
"id": 123
|
|
}
|
|
```
|
|
|
|
字段说明：
|
|
|
|
| 字段名 | 类型 | 必填 | 说明 |
|
|
| ------ | ------ | ---- | ---------- |
|
|
| `id` | number | 是 | 评论 ID |
|
|
|
|
**成功响应**
|
|
|
|
- 状态码：`200`
|
|
|
|
```json
|
|
{
|
|
"message": "取消点赞成功",
|
|
"likes": 4
|
|
}
|
|
```
|
|
|
|
字段说明：
|
|
|
|
| 字段名 | 类型 | 说明 |
|
|
| ------- | ------ | -------------- |
|
|
| `likes` | number | 更新后的点赞数 |
|
|
|
|
**错误响应**
|
|
|
|
- 状态码：`400`
|
|
|
|
```json
|
|
{
|
|
"message": "评论不存在"
|
|
}
|
|
```
|