查询商品专辑详情

GET 
/openapi/2025-06/collections/:id

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

请求

Path参数

id string必填

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

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

collection object

专辑详情

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 格式）

示例

{
  "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"
    }
  }
}