查询商品专辑列表

GET 
/openapi/2025-06/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，用于筛选包含该商品的专辑

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

collections object[]

专辑列表

Array [

idstring

专辑 ID

titlestring

专辑名称

descriptionstring

专辑描述

handlestring

专辑 handle（URL 友好的唯一别名）

smartboolean

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

image object

专辑封面

srcstring

图片源 URL

widthint32

宽度尺寸

heightint32

高度尺寸

altstring

图片替代文本

seo_titlestring

专辑的 SEO 标题

seo_keywordsstring[]

SEO 关键词列表

seo_descriptionstring

专辑的 SEO 描述

sort_orderstring

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

created_atstring

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

updated_atstring

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

]

cursorstring

分页游标

has_moreboolean

是否还有更多记录

示例

{
  "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"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}