Carousel Management

Interfaces for managing homepage carousels.

Get Carousel List

Get all carousels.

Interface Information

• Endpoint: GET /api/admin/carousels
• Authentication: Required (admin permission)

Create Carousel

Create new carousel.

Interface Information

• Endpoint: POST /api/admin/carousels
• Authentication: Required (admin permission)

Request Parameters

Parameter	Type	Required	Description
title	string	Yes	Carousel title
imageUrl	string	Yes	Image URL
linkUrl	string	No	Link address
order	number	No	Sort order, default 0
status	string	No	Status: active/inactive, default active

Request Example

curl -X POST http://localhost:3000/api/admin/carousels \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Welcome to My Blog",
    "imageUrl": "https://example.com/banner.jpg",
    "linkUrl": "/articles/1",
    "order": 1
  }'

Update Carousel

Update existing carousel.

Interface Information

• Endpoint: PUT /api/admin/carousels/:id
• Authentication: Required (admin permission)

Request Example

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 Carousel

Delete specified carousel.

Interface Information

• Endpoint: DELETE /api/admin/carousels/:id
• Authentication: Required (admin permission)

Request Example

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

Error Responses

HTTP Status Code	Description
401	Not logged in or token invalid
403	Insufficient permission (non-admin)
404	Carousel does not exist
400	Parameter error
500	Server error