feat: 更新公告和链接状态接口,增强参数校验,支持跳转链接最大长度为5000字符,添加异步保存完成图片功能,优化接口文档和数据库结构

This commit is contained in:
yahaozhang
2025-11-03 20:56:34 +08:00
parent f43320138a
commit cadf8d98cb
40 changed files with 3148 additions and 17 deletions

View File

@@ -184,6 +184,22 @@ curl -X PUT "http://localhost:8080/api/admin/announcement/1/enabled?enabled=fals
}
```
**400 Bad Request** - 字段长度超限:
```json
{
"timestamp": "2023-12-01T10:00:00.000+00:00",
"status": 400,
"error": "Bad Request",
"message": "Validation failed",
"errors": [
{
"field": "jumpUrl",
"message": "跳转链接长度不能超过5000个字符"
}
]
}
```
**404 Not Found** - 公告不存在:
```json
{
@@ -200,17 +216,19 @@ curl -X PUT "http://localhost:8080/api/admin/announcement/1/enabled?enabled=fals
2. 公告标题和内容不能为空
3. `enabled` 字段默认为 `false`
4. `jumpUrl` 字段可选,用于设置点击公告后的跳转链接
5. 获取启用公告的接口最多返回10条记录
6. 所有时间字段使用 ISO 8601 格式
5. `jumpUrl` 字段最大长度为 **5000个字符**,超过此限制将返回验证错误
6. 获取启用公告的接口最多返回10条记录
7. 所有时间字段使用 ISO 8601 格式
## 数据库表结构
公告数据存储在 `announcement` 表中,包含以下字段:
- `id` - 主键,自增
- `title` - 公告标题
- `content` - 公告内容
- `enabled` - 启用状态
- `jump_url` - 跳转链接
- `created_at` - 创建时间
- `updated_at` - 更新时间
- `title` - 公告标题 (VARCHAR(100))
- `content` - 公告内容 (TEXT)
- `enabled` - 启用状态 (TINYINT(1))
- `jump_url` - 跳转链接 (VARCHAR(5000)),可选
- `belong_id` - 归属ID (INT)关联用户ID
- `created_at` - 创建时间 (DATETIME(3))
- `updated_at` - 更新时间 (DATETIME(3))