feat: 更新公告和链接状态接口,增强参数校验,支持跳转链接最大长度为5000字符,添加异步保存完成图片功能,优化接口文档和数据库结构
This commit is contained in:
@@ -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))
|
||||
|
||||
Reference in New Issue
Block a user