系统设置
管理系统配置的接口。
获取系统设置
获取所有系统配置。
接口信息
- 请求路径:
GET /api/admin/settings - 认证方式: 需要认证（管理员权限）
响应字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| siteName | string | 网站名称 |
| siteDescription | string | 网站描述 |
| siteKeywords | array | 网站关键词 |
| authorName | string | 作者名称 |
| authorAvatar | string | 作者头像 URL |
| socialLinks | object | 社交媒体链接 |
| pageSize | number | 每页显示数量 |
| allowComments | boolean | 是否允许评论 |
更新系统设置
更新系统配置。
接口信息
- 请求路径:
PUT /api/admin/settings - 认证方式: 需要认证（管理员权限）
请求参数
所有字段均为可选，只更新传入的字段。
请求示例
bash
curl -X PUT http://localhost:3000/api/admin/settings \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"siteName": "我的博客",
"allowComments": true
}'清除缓存
清除系统缓存。
接口信息
- 请求路径:
POST /api/admin/settings/clear-cache - 认证方式: 需要认证（管理员权限）
请求示例
bash
curl -X POST http://localhost:3000/api/admin/settings/clear-cache \
-H "Authorization: Bearer your-jwt-token"错误响应
| HTTP 状态码 | 说明 |
|---|---|
| 401 | 未登录或 Token 无效 |
| 403 | 权限不足（非管理员） |
| 400 | 参数错误 |
| 500 | 服务器错误 |