关于BigCommerce API的两项技术需求：变体折扣码与Webhook

1. 创建变体专属折扣码 #

可以创建仅适用于特定商品变体的折扣码，只需在请求的applies_to字段中指定entity为variants，并填入目标变体的ID列表即可，API地址与商品折扣码一致，使用v2优惠券接口。

请求示例：

{
  "name": "Variant Discount Test",
  "type": "per_item_discount",
  "amount": "5",
  "expires": "Sat, 15 Mar 2025 12:00:00 +0000",
  "enabled": true,
  "code": "VARIANT5OFF",
  "applies_to": {
    "entity": "variants",
    "ids": [
        "222" // 替换为实际的变体ID
    ]
  },
  "max_uses": 1,
  "max_uses_per_customer": 0
}

2. 变体更新Webhook #

BigCommerce目前没有单独的变体更新专属Webhook，编辑变体时不会触发商品更新Webhook。追踪变体变更的推荐方案有两种：

• 方案一：复用商品更新Webhook做二次校验
  当商品更新Webhook触发时，调用商品变体列表API（如v3的/catalog/products/{product_id}/variants）拉取当前所有变体数据，与本地缓存的该商品变体快照进行字段对比（比如价格、库存、SKU等），以此识别出具体变更的变体。

• 方案二：定时轮询变体API
  定期调用变体相关API（如v2的/products/{product_id}/variants或v3的对应接口），拉取变体数据后与上次存储的版本进行比对，检测变更。轮询间隔可根据业务需求设置（比如15分钟、1小时），避免过于频繁调用导致API限流。

内容的提问来源于stack exchange，提问作者Adith C p