视频号
取消
中文
中文
EN
取消
  • 介绍

    • # 团长商品变更通知

    # 接口说明

    视频号小店将通过此接口向团长发送商品变更的通知。

    # 注意事项

    • 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，商户将无法收视频号小店发送的通知；

    # 请求参数说明

    参数 类型 描述
    ToUserName string 团长UserName
    FromUserName string 微信团队的 OpenID(固定值)
    CreateTime number 事件时间,Unix时间戳
    MsgType string 消息类型,固定为 event
    Event string 事件类型,本接口固定为 head_supplier_item_update
    item_info object ItemInfo 事件主体，结构体详情请参考ItemInfo

    # 请求参数示例（解密后的明文JSON）

    {
    "ToUserName": "gh_*", 
    "FromUserName": "OPENID", 
    "CreateTime": 1662480000, 
    "MsgType": "event", 
    "Event": "head_supplier_item_update", 
    "item_info": {
        "event_type": 2,
        "appid": "APPID",
        "product_id": "12345",
        "version": "1677488955",
        "update_fields": ["commission_ratio","service_ratio","status","active_time"]
    }
}

    # 返回参数说明

    只需直接返回字符串：success

    # 返回参数示例

    success

    # 结构体

    # ItemInfo

    事件主体

    字段名 类型 描述
    event_type number 商品变更类型，1：新增商品；2：更新商品
    appid string 团长商品所属小店appid
    product_id string(uint64) 商品id
    version string 商品版本号
    update_fields string array 商品更新字段，当event_type = 2时有值。commission_ratio、service_ratio、status、active_time分别表示佣金、服务费、商品状态和合作生效时间有变更