Skip to content

图库管理

管理图片库的接口。

获取图库列表

获取所有图库。

接口信息

  • 请求路径: GET /api/admin/galleries
  • 认证方式: 需要认证(管理员权限)

创建图库

创建新图库。

接口信息

  • 请求路径: POST /api/admin/galleries
  • 认证方式: 需要认证(管理员权限)

请求参数

参数名类型必填说明
titlestring图库名称
descriptionstring描述
coverImagestring封面图片 URL
ordernumber排序,默认 0

请求示例

bash
curl -X POST http://localhost:3000/api/admin/galleries \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "摄影作品",
    "description": "我的摄影作品集"
  }'

上传图片到图库

上传图片到指定图库。

接口信息

  • 请求路径: POST /api/admin/galleries/:id/images
  • 认证方式: 需要认证(管理员权限)

请求参数

使用 multipart/form-data 格式上传。

参数名类型必填说明
imagesfile图片文件(支持多张)

请求示例

bash
curl -X POST http://localhost:3000/api/admin/galleries/1/images \
  -H "Authorization: Bearer your-jwt-token" \
  -F "images=@photo1.jpg" \
  -F "images=@photo2.jpg"

更新图库

更新已有图库。

接口信息

  • 请求路径: PUT /api/admin/galleries/:id
  • 认证方式: 需要认证(管理员权限)

删除图库

删除指定图库。

接口信息

  • 请求路径: DELETE /api/admin/galleries/:id
  • 认证方式: 需要认证(管理员权限)

错误响应

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