图库
获取图库列表和图片的接口。
获取图库列表
获取所有公开的图库。
接口信息
- 请求路径:
GET /api/galleries - 认证方式: 无需认证(公开接口)
获取图库详情
获取指定图库的详细信息和图片列表。
接口信息
- 请求路径:
GET /api/galleries/:id - 认证方式: 无需认证(公开接口)
路径参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | number | 是 | 图库 ID |
响应字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | number | 图库 ID |
| title | string | 图库名称 |
| description | string | 描述 |
| coverImage | string | 封面图片 URL |
| images | array | 图片列表 |
| images[].id | number | 图片 ID |
| images[].url | string | 图片 URL |
| images[].thumbnail | string | 缩略图 URL |
请求示例
bash
curl http://localhost:3000/api/galleries/1响应示例
json
{
"success": true,
"data": {
"id": 1,
"title": "摄影作品",
"description": "我的摄影作品集",
"coverImage": "https://example.com/cover.jpg",
"images": [
{
"id": 1,
"url": "https://example.com/image1.jpg",
"thumbnail": "https://example.com/image1-thumb.jpg"
}
]
}
}错误响应
| HTTP 状态码 | 说明 |
|---|---|
| 404 | 图库不存在 |
| 500 | 服务器错误 |