文档 / 图纸社区 Patterns / 图纸详情

图纸详情

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

注意 data 包在 pattern 键下。每次访问 view_count+1。带 Token 时 liked / author.followed 才有意义。

模拟请求

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

POST

携带 Authorization

Body（JSON）

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

响应

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

请求 Body

无 Body（或仅 Path/Query）。

响应 `data` 字段说明

字段	类型 / 说明
`id`	int, 图纸 ID
`title`	string, 标题
`description`	string, 简介
`cover_url`	string, 封面图 URL
`category`	object\|null, {id, slug, name}；name 随语言本地化，slug 固定；未分类为 null
`width`	int, 格数宽
`height`	int, 格数高
`color_count`	int, 用色数
`bead_count`	int, 拼豆数量
`difficulty`	int, 难度 1–5
`view_count`	int, 浏览量
`like_count`	int, 点赞数
`favorite_count`	int, 收藏数
`heat`	int, 热度=like×3+favorite×2+view
`published_at`	string\|null, 发布时间 UTC
`created_at`	string\|null, 创建时间 UTC
`author`	object, {id, username, nickname, avatar_url}；作者已注销时 nickname 为本地化文案
`images`	array<string>, 详情图 URL 列表
`status`	int, 0草稿 1已发布 2下架
`liked`	bool, 当前用户是否已赞；未登录恒为 false
`author.followed`	bool, 是否已关注画师；未登录恒为 false

完整响应示例

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

{
    "code": 0,
    "message": "ok",
    "data": {
        "pattern": {
            "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": "",
                "followed": false
            },
            "images": [
                "/uploads/patterns/demo_strawberry.png",
                "/uploads/patterns/demo_strawberry_2.png"
            ],
            "status": 1,
            "liked": false
        }
    }
}