# 简易匿名社区

**Repository Path**: meda/anonymous_bbs

## Basic Information

- **Project Name**: 简易匿名社区
- **Description**: 一个Spring boot 练手项目
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://cloud.kicsy.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-22
- **Last Updated**: 2025-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README




 > # 项目不在更新，2025.09.23，已开源
# 项目接口文档

**版本**: Vbeat0.1

**描述**: 简易匿名社区接口文档

## API 接口

### PUT /api/notifications/{notificationId}/read

**摘要**: 标记单条通知已读

**描述**: 将指定的通知标记为已读状态

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| notificationId | path | 通知ID | 是 | integer |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 标记成功 |

---

### PUT /api/notifications/read-all

**摘要**: 标记所有通知已读

**描述**: 将当前用户的所有通知标记为已读状态

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 标记成功 |

---

### GET /api/posts

**摘要**: 获取帖子列表

**描述**: 获取所有帖子列表，按创建时间降序排列

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 获取成功 |

---

### POST /api/posts

**摘要**: 发布新帖子

**描述**: 用户发布匿名帖子

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 发布成功 |
| 400 | 发布失败 |

---

### POST /api/posts/{postId}/like

**摘要**: 点赞帖子

**描述**: 为帖子点赞

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| postId | path | 帖子ID | 是 | integer |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 400 | 点赞失败 |
| 200 | 点赞成功 |

---

### POST /api/comments

**摘要**: 发表评论

**描述**: 为帖子发表匿名评论

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 评论成功 |
| 400 | 评论失败 |

---

### POST /api/comments/{parentCommentId}/reply

**摘要**: 回复评论

**描述**: 回复其他用户的评论

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| parentCommentId | path | 父评论ID | 是 | integer |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 回复成功 |
| 400 | 回复失败 |

---

### POST /api/comments/{commentId}/like

**摘要**: 点赞评论

**描述**: 为评论点赞

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| commentId | path | 评论ID | 是 | integer |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 点赞成功 |
| 400 | 点赞失败 |

---

### POST /api/admin/sensitive-words

**摘要**: 添加敏感词

**描述**: 添加新的敏感词到过滤系统

#### 响应

| 状态码 | 描述 |
|--------|------|
| 400 | 添加失败 |
| 200 | 添加成功 |
| 401 | 管理员密码验证失败 |

---

### DELETE /api/admin/sensitive-words

**摘要**: 移除敏感词

**描述**: 从过滤系统中移除敏感词

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 移除成功 |
| 400 | 移除失败 |
| 401 | 管理员密码验证失败 |

---

### POST /api/admin/ban/temporary

**摘要**: 临时封禁IP

**描述**: 临时封禁指定的IP地址一段时间

#### 响应

| 状态码 | 描述 |
|--------|------|
| 401 | 管理员密码验证失败 |
| 400 | 封禁失败 |
| 200 | 封禁成功 |

---

### POST /api/admin/ban/permanent

**摘要**: 永久封禁IP

**描述**: 永久封禁指定的IP地址

#### 响应

| 状态码 | 描述 |
|--------|------|
| 401 | 管理员密码验证失败 |
| 400 | 封禁失败 |
| 200 | 封禁成功 |

---

### GET /api/posts/{postId}

**摘要**: 获取帖子详情

**描述**: 根据帖子ID获取帖子详细信息

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| postId | path | 帖子ID | 是 | integer |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 404 | 帖子不存在 |
| 200 | 获取成功 |

---

### GET /api/posts/{postId}/comments

**摘要**: 获取帖子评论列表

**描述**: 获取指定帖子的所有根评论

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| postId | path | 帖子ID | 是 | integer |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 获取成功 |

---

### GET /api/notifications

**摘要**: 获取所有通知

**描述**: 获取当前用户的所有通知

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 获取成功 |

---

### GET /api/notifications/unread

**摘要**: 获取未读通知

**描述**: 获取当前用户的所有未读通知

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 获取成功 |

---

### GET /api/comments/{commentId}/replies

**摘要**: 获取评论回复列表

**描述**: 获取指定评论的所有回复

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| commentId | path | 评论ID | 是 | integer |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 获取成功 |

---

### GET /api/admin/ban/status

**摘要**: 检查IP封禁状态

**描述**: 检查指定IP地址是否被封禁

#### 参数

| 名称 | 位置 | 描述 | 必填 | 类型 |
|------|------|------|------|------|
| ipAddress | query | IP地址 | 是 | string |
| password | query | 管理员密码 | 是 | string |

#### 响应

| 状态码 | 描述 |
|--------|------|
| 200 | 检查成功 |
| 401 | 管理员密码验证失败 |
| 400 | 检查失败 |

---

### DELETE /api/admin/ban

**摘要**: 解除IP封禁

**描述**: 解除对指定IP地址的封禁

#### 响应

| 状态码 | 描述 |
|--------|------|
| 401 | 管理员密码验证失败 |
| 200 | 解除成功 |
| 400 | 解除失败 |

---