Skip to content

图库

获取图库列表和图片的接口。

获取图库列表

获取所有公开的图库。

接口信息

  • 请求路径: GET /api/galleries
  • 认证方式: 无需认证(公开接口)

获取图库详情

获取指定图库的详细信息和图片列表。

接口信息

  • 请求路径: GET /api/galleries/:id
  • 认证方式: 无需认证(公开接口)

路径参数

参数名类型必填说明
idnumber图库 ID

响应字段

字段名类型说明
idnumber图库 ID
titlestring图库名称
descriptionstring描述
coverImagestring封面图片 URL
imagesarray图片列表
images[].idnumber图片 ID
images[].urlstring图片 URL
images[].thumbnailstring缩略图 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服务器错误