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