商品专辑创建

Webhookcollections/create

商品专辑创建时触发。

需要 collection 访问权限。最低支持版本：202007。

请求头

X-Shoplazza-Topicstring
触发本次推送的事件，例如 orders/create
示例： orders/create
X-Shoplazza-Hmac-Sha256string

请求体的 HMAC-SHA256 签名（base64 编码），使用应用的 Client Secret 生成，用于验证请求来自 Shoplazza

X-Shoplazza-Shop-Domainstring
产生该事件的店铺域名
示例： example.myshoplaza.com
X-Shoplazza-Api-Versionstring
序列化 payload 使用的 API 版本
示例： 2025-06
X-Shoplazza-Deduplication-IDstring

本次推送的去重 ID，同一事件重发时保持不变，用于幂等去重

请求体

数据结构

• collection object

  idstring

  专辑 ID

  titlestring

  专辑名称

  handlestring

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

  descriptionstring

  专辑描述

  MetaKeywordstring

  SEO 关键词列表

  meta_titlestring

  专辑的 SEO 标题

  meta_descriptionstring

  专辑的 SEO 描述

  sort_orderstring

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

  urlstring

  C 端专辑详情页 URL（不含店铺域名）

  created_atstring

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

  updated_atstring

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

  image object

  专辑封面

  srcstring

  图片来源 URL

  pathstring

  图片路径（不含域名；src 含域名）

  widthinteger

  图片宽度（像素）

  heightinteger

  图片高度（像素）

示例

{
  "collection": {
    "id": "string",
    "title": "string",
    "handle": "string",
    "description": "string",
    "MetaKeyword": "string",
    "meta_title": "string",
    "meta_description": "string",
    "sort_order": "string",
    "url": "string",
    "created_at": "string",
    "updated_at": "string",
    "image": {
      "src": "string",
      "path": "string",
      "width": 0,
      "height": 0
    }
  }
}