相册接口

相册管理相关接口。

获取相册列表

请求

GET /api/albums
Authorization: Bearer {token}

参数

参数	类型	必填	说明
page	int	否	页码
limit	int	否	每页数量
user_id	int	否	用户ID

响应

{
    "code": 0,
    "data": {
        "list": [
            {
                "id": 1,
                "name": "风景集",
                "description": "美丽的风景照片",
                "cover": "/storage/photos/cover.jpg",
                "photo_count": 50,
                "is_public": 1,
                "create_time": "2025-01-18 10:00:00"
            }
        ],
        "pagination": {...}
    }
}

创建相册

请求

POST /api/albums
Authorization: Bearer {token}
Content-Type: application/json

参数

参数	类型	必填	说明
name	string	是	相册名称
description	string	否	描述
is_public	int	否	1公开 0私密
password	string	否	访问密码

响应

{
    "code": 0,
    "message": "创建成功",
    "data": {
        "id": 1,
        "name": "新相册"
    }
}

获取相册详情

GET /api/albums/{id}

更新相册

PUT /api/albums/{id}
Authorization: Bearer {token}

删除相册

DELETE /api/albums/{id}
Authorization: Bearer {token}

添加图片到相册

POST /api/albums/{id}/photos
Authorization: Bearer {token}

{
    "photo_ids": [1, 2, 3]
}

从相册移除图片

DELETE /api/albums/{id}/photos/{photo_id}
Authorization: Bearer {token}

设置相册封面

PUT /api/albums/{id}/cover
Authorization: Bearer {token}

{
    "photo_id": 123
}