商品更新

Webhookproducts/update

商品更新时触发。

需要 product 访问权限。最低支持版本：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，同一事件重发时保持不变，用于幂等去重

请求体

数据结构
示例

product object
briefstring
商品简介
created_atstring
商品创建时间
descriptionstring
商品描述
handlestring
商品 handle（用于 URL 的友好别名）
has_only_default_variantboolean
是否仅有默认款式（即无多款式）
idstring
商品 ID
image object
商品主图
altstring
图片替代文本（alt）
heightinteger
图片高度（单位：像素）
pathstring
图片存储路径
srcstring
图片 URL
watermark_srcstring
水印图片 URL
watermark_template_idstring
水印模板 ID
widthinteger
图片宽度（单位：像素）
images object[]
商品图片列表
Array [
altstring
图片替代文本（alt）
heightinteger
图片高度（单位：像素）
idstring
图片 ID
pathstring
图片存储路径
srcstring
图片 URL
widthinteger
图片宽度（单位：像素）
]
inventory_policystring
库存策略，可选值：continue（缺货时继续销售）、deny（缺货时停止销售）、auto_unpublished（缺货时自动下架）；当 inventory_tracking 为 true 时必填
inventory_quantityinteger
库存数量
inventory_trackingboolean
是否启用库存追踪
meta_descriptionstring
SEO 描述
meta_keywordstring
SEO 关键词列表，多个值之间使用英文逗号分隔，例如：key1,key2
meta_titlestring
SEO 标题
need_variant_imageboolean
是否需要为款式设置图片；当 has_only_default_variant 为 false 时必填
notestring
自定义备注，例如："This is a customizable product"
options object[]
商品款式属性列表（如颜色、尺寸等）
Array [
idstring
款式属性 ID
namestring
款式属性名称，例如："color"、"size"
positioninteger
款式属性排序位置
product_idstring
所属商品 ID
valuesundefined[]
款式属性的可选值列表，例如：["red", "black"]、["small", "large"]
]
publishedboolean
商品是否已上架
published_atstring
商品上架时间
requires_shippingboolean
商品是否需要物流
spustring
商品 SPU（标准产品单元）
tagsstring
商品标签列表
taxableboolean
商品是否需要计税
titlestring
商品名称
updated_atstring
商品最后更新时间
variants object[]
商品子款式列表
Array [
barcodestring
条形码
compare_at_pricestring
划线价
cost_pricestring
成本价
created_atstring
子款式创建时间
idstring
子款式 ID
image object
子款式图片
altstring
图片替代文本（alt）
heightinteger
图片高度（单位：像素）
pathstring
图片存储路径
srcstring
图片 URL
watermark_srcstring
水印图片 URL
watermark_template_idstring
水印模板 ID
widthinteger
图片宽度（单位：像素）
inventory_quantityinteger
库存数量
notestring
款式备注
option1string
子款式在第 1 个商品款式属性上的取值
option2string
子款式在第 2 个商品款式属性上的取值
option3string
子款式在第 3 个商品款式属性上的取值
positioninteger
子款式在商品中的排序位置
pricestring
子款式售价
product_idstring
子款式所属商品的 ID
skustring
SKU
titlestring
子款式标题
updated_atstring
子款式最后更新时间
weightstring
重量
weight_unitstring
重量单位，可选值：kg、g、lb、oz
]
vendorstring
供应商名称
vendor_urlstring
供应商 URL

{
  "product": {
    "brief": "string",
    "created_at": "string",
    "description": "string",
    "handle": "string",
    "has_only_default_variant": true,
    "id": "string",
    "image": {
      "alt": "string",
      "height": 0,
      "path": "string",
      "src": "string",
      "watermark_src": "string",
      "watermark_template_id": "string",
      "width": 0
    },
    "images": [
      {
        "alt": "string",
        "height": 0,
        "id": "string",
        "path": "string",
        "src": "string",
        "width": 0
      }
    ],
    "inventory_policy": "string",
    "inventory_quantity": 0,
    "inventory_tracking": true,
    "meta_description": "string",
    "meta_keyword": "string",
    "meta_title": "string",
    "need_variant_image": true,
    "note": "string",
    "options": [
      {
        "id": "string",
        "name": "string",
        "position": 0,
        "product_id": "string",
        "values": [
          null
        ]
      }
    ],
    "published": true,
    "published_at": "string",
    "requires_shipping": true,
    "spu": "string",
    "tags": "string",
    "taxable": true,
    "title": "string",
    "updated_at": "string",
    "variants": [
      {
        "barcode": "string",
        "compare_at_price": "string",
        "cost_price": "string",
        "created_at": "string",
        "id": "string",
        "image": {
          "alt": "string",
          "height": 0,
          "path": "string",
          "src": "string",
          "watermark_src": "string",
          "watermark_template_id": "string",
          "width": 0
        },
        "inventory_quantity": 0,
        "note": "string",
        "option1": "string",
        "option2": "string",
        "option3": "string",
        "position": 0,
        "price": "string",
        "product_id": "string",
        "sku": "string",
        "title": "string",
        "updated_at": "string",
        "weight": "string",
        "weight_unit": "string"
      }
    ],
    "vendor": "string",
    "vendor_url": "string"
  }
}

请求头​

请求体​

请求头

请求体