文档 / 画师专辑 Albums / 专辑详情 + 内含图纸

专辑详情 + 内含图纸

GET|POST /api/albums/{id} 公开

仅展示专辑内已发布图纸。

模拟请求

已预填本接口参数，可直接改 Body 后发送。验证码 mock：1111；注册/登录成功后自动缓存 token。

POST

携带 Authorization

Body（JSON）

占位符 {{refresh_token}} / {{access_token}} 发送时自动替换。

响应

点击「发送请求」查看结果

请求 Body 字段

字段	说明
`page`	int, 可选
`page_size`	int, 可选, 默认 20

响应 `data` 字段说明

字段	类型 / 说明
`album`	object, 专辑信息（含 author、pattern_count）
`patterns`	array, 图纸卡片列表
`page`	int
`total`	int
`has_more`	bool

完整响应示例

成功时的整包 JSON（APP 可按此解析）。统一外壳 code / message / data。

{
    "code": 0,
    "message": "ok",
    "data": {
        "album": {
            "id": 1,
            "title": "精选作品",
            "description": "我最推荐的拼豆图纸合集。",
            "cover_url": "/uploads/patterns/demo.png",
            "sort_order": 10,
            "status": 1,
            "pattern_count": 24,
            "user_id": 2,
            "author": {
                "id": 2,
                "username": "pixel_cat",
                "nickname": "像素猫",
                "avatar_url": ""
            }
        },
        "patterns": [
            {
                "id": 2,
                "title": "草莓拼豆图纸",
                "description": "可爱草莓，粉红主色，适合钥匙扣。",
                "cover_url": "/uploads/patterns/demo_strawberry.png",
                "category": {
                    "id": 5,
                    "slug": "fruit",
                    "name": "Fruit"
                },
                "width": 24,
                "height": 28,
                "color_count": 12,
                "bead_count": 520,
                "difficulty": 1,
                "view_count": 920,
                "like_count": 86,
                "favorite_count": 30,
                "heat": 1238,
                "published_at": "2026-08-02 08:04:54",
                "created_at": "2026-08-02 08:04:54",
                "author": {
                    "id": 2,
                    "username": "pixel_cat",
                    "nickname": "像素猫",
                    "avatar_url": ""
                }
            }
        ],
        "page": 1,
        "page_size": 20,
        "total": 24,
        "has_more": true
    }
}