**版本：202701**

# 查询商品专辑列表

**GET** `/openapi/2027-01/collections`

根据商品 ID、专辑名称、更新时间等筛选条件分页查询商品专辑列表。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页返回的记录数，范围 1-100，默认 10
- `ids` string[]

  指定要查询的专辑 ID 列表。 示例：?ids=1001&ids=1002
- `title` string

  按专辑名称模糊筛选
- `updated_at_min` string

  筛选最后更新时间不早于该时间点的专辑，例如：`2018-10-01T16:15:47-04:00`
- `updated_at_max` string

  筛选最后更新时间不晚于该时间点的专辑，例如：`2018-10-01T16:15:47-04:00`
- `product_id` string

  商品 UUID，用于筛选包含该商品的专辑
- `smart` boolean

  是否仅返回智能专辑：`true` 仅返回智能专辑，`false` 仅返回手动专辑，不传则不限

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `collections` object[]

    专辑列表

    *   Array \[

    - `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

      集合中的商品数量
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否还有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "collections": [
      {
        "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
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```