轮播图管理

管理首页轮播图的接口。

获取轮播图列表

获取所有轮播图。

接口信息

• 请求路径: GET /api/admin/carousels
• 认证方式: 需要认证（管理员权限）

创建轮播图

创建新轮播图。

接口信息

• 请求路径: POST /api/admin/carousels
• 认证方式: 需要认证（管理员权限）

请求参数

参数名	类型	必填	说明
title	string	是	轮播图标题
imageUrl	string	是	图片 URL
linkUrl	string	否	链接地址
order	number	否	排序，默认 0
status	string	否	状态：active/inactive，默认 active

请求示例

curl -X POST http://localhost:3000/api/admin/carousels \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "欢迎来到我的博客",
    "imageUrl": "https://example.com/banner.jpg",
    "linkUrl": "/articles/1",
    "order": 1
  }'

更新轮播图

更新已有轮播图。

接口信息

• 请求路径: PUT /api/admin/carousels/:id
• 认证方式: 需要认证（管理员权限）

请求示例

curl -X PUT http://localhost:3000/api/admin/carousels/1 \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "order": 2
  }'

删除轮播图

删除指定轮播图。

接口信息

• 请求路径: DELETE /api/admin/carousels/:id
• 认证方式: 需要认证（管理员权限）

请求示例

curl -X DELETE http://localhost:3000/api/admin/carousels/1 \
  -H "Authorization: Bearer your-jwt-token"

错误响应

HTTP 状态码	说明
401	未登录或 Token 无效
403	权限不足（非管理员）
404	轮播图不存在
400	参数错误
500	服务器错误