图库管理
管理图片库的接口。
获取图库列表
获取所有图库。
接口信息
- 请求路径:
GET /api/admin/galleries - 认证方式: 需要认证(管理员权限)
创建图库
创建新图库。
接口信息
- 请求路径:
POST /api/admin/galleries - 认证方式: 需要认证(管理员权限)
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 图库名称 |
| description | string | 否 | 描述 |
| coverImage | string | 否 | 封面图片 URL |
| order | number | 否 | 排序,默认 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 格式上传。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| images | file | 是 | 图片文件(支持多张) |
请求示例
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 | 服务器错误 |