# 商品上下架

# 接口说明

视频号小店会通过该接口将商品的上下架操作消息通知给商户

# 注意事项

  • 回调url设置和消息推送规则需参考消息推送文档 ,如果设置的回调url无法访问,商户将无法收视频号小店发送的通知;
  • 通知是以POST方法访问商户设置的通知url,通知的数据以JSON格式通过请求主体(BODY)传输。通知的数据包括了加密的回调,要得到明文JSON串需进行解密,解密步骤和规则需参考消息加解密说明文档

# 请求参数说明

参数 类型 描述
ToUserName string 小店UserName
FromUserName string 微信团队的 OpenID(固定值)
CreateTime number 事件时间,Unix时间戳(即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒起至现在的总秒数)
MsgType string 消息类型,固定为 event
Event string 事件类型,本接口固定为 product_spu_listing
ProductSpuListing object 事件主体具体结构请参考ProductSpuListing结构体

# 请求参数示例(解密后的明文JSON)

{
    "ToUserName":"gh_*",
    "FromUserName":"OPENID",
    "CreateTime":1662480000,
    "MsgType":"event",
    "Event":"product_spu_listing",
    "ProductSpuListing": {
        "product_id":"12345678",
        "status":3,
        "reason":"abc"
    }
}

# 返回参数说明

只需直接返回字符串:success

# 返回参数示例

success

# 结构体

# ProductSpuListing

事件主体

参数 类型 描述
product_id string 商品ID
status number 状态。5:上架;11:自主下架;13:系统下架;14:保证金违规下架;15:品牌到期下架; 20:封禁下架。
reason string 下架原因,非必填字段