**版本：202601**

# 查询商品专辑详情

**GET** `/openapi/2026-01/collections/:id`

通过唯一 ID 获取指定商品专辑的详细信息。

## 请求

**Path参数**

- `id` string (required)

  待查询的专辑 ID（UUID 格式）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `collection` object

    专辑详情

    - `id` string

      专辑 ID
    - `title` string

      专辑名称
    - `description` string

      专辑描述
    - `handle` string

      专辑 handle（URL 友好的唯一别名）
    - `smart` boolean

      是否为智能专辑（满足条件的商品自动加入）
    - `image` object

      专辑封面

      - `src` string

        图片来源 URL
      - `width` int32

        图片宽度（像素）
      - `height` int32

        图片高度（像素）
      - `alt` string

        图片替代文本
    - `seo_title` string

      专辑的 SEO 标题
    - `seo_keywords` string[]

      SEO 关键词列表
    - `seo_description` string

      专辑的 SEO 描述
    - `sort_order` string

      专辑内商品的排序规则（取值见创建专辑接口）
    - `created_at` string

      专辑创建时间（ISO-8601 格式）
    - `updated_at` string

      专辑最后更新时间（ISO-8601 格式）
    - `match_rules` object

      智能集合匹配规则

      - `disjunctive` boolean

        条件是否为析取关系（OR）
      - `rule_modules` object[]

        规则模块列表

        *   Array \[

        - `disjunctive` boolean

          条件是否为析取关系（OR）
        - `rules` object[]

          此模块中的规则列表

          *   Array \[

          - `column` string

            列
          - `relation` string

            关联关系
          - `condition` string

            条件
          *   \]
        *   \]
    - `tags` string[]

      集合标签列表
    - `product_count` int64

      集合中的商品数量

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "collection": {
      "id": "string",
      "title": "string",
      "description": "string",
      "handle": "string",
      "smart": true,
      "image": {
        "src": "string",
        "width": 0,
        "height": 0,
        "alt": "string"
      },
      "seo_title": "string",
      "seo_keywords": [
        "string"
      ],
      "seo_description": "string",
      "sort_order": "string",
      "created_at": "string",
      "updated_at": "string",
      "match_rules": {
        "disjunctive": true,
        "rule_modules": [
          {
            "disjunctive": true,
            "rules": [
              {
                "column": "string",
                "relation": "string",
                "condition": "string"
              }
            ]
          }
        ]
      },
      "tags": [
        "string"
      ],
      "product_count": 0
    }
  }
}
```