直播间商品上下架事件推送

推送参数

其他默认推送参数文档，参考消息推送-使用说明。

当直播间商品发生上下架变更时，平台会向商家配置的消息推送地址发送事件通知，支持商家系统实时同步直播间商品状态。

参数	必选	类型	描述
msg_type	是	string	消息类型：event-事件
event	是	string	事件类型：roomGoodsShelfChange-直播间商品上下架变更
data	是	object	消息内容

data 参数结构

参数	必选	类型	描述
uid	是	int	商户 ID
room_id	是	int	直播间 ID
custom_menu_id	是	int	商品菜单 ID
goods_ids	是	string	商品 ID，多个用逗号拼接（如 1001,1002,1003）
action	是	string	操作类型：add-商品上架，delete-商品下架

action 枚举说明

取值	描述
add	商品上架（添加到直播间）
delete	商品下架（从直播间移除）

触发场景说明

场景	action	说明
单个商品上架	add	商品添加到直播间橱窗时触发，包含该商品 ID
多个商品上架	add	批量添加商品到直播间时触发，包含所有商品 ID
单个商品下架	delete	商品从直播间移除时触发，包含该商品 ID
批量商品下架	delete	批量删除商品时，按每个受影响直播间分别推送，包含各直播间下的商品 ID

推送示例

{
  "key": "示例key",
  "timestamp": 1741430400000,
  "sign": "md5sign",
  "msg_id": "2177E51538CC0078F0AXXX",
  "msg_type": "event",
  "event": "roomGoodsShelfChange",
  "push_msg_url": "https://example.com/push/roomGoodsShelfChange",
  "uid": 123456,
  "data": {
    "uid": 123456,
    "room_id": 10001,
    "custom_menu_id": 20001,
    "goods_ids": "1001,1002,1003",
    "action": "add",
    "add_time": 1741430400
  }
}

批量下架示例

{
  "key": "示例key",
  "timestamp": 1741430500000,
  "sign": "md5sign",
  "msg_id": "2177E51538CC0078F0AXXX",
  "msg_type": "event",
  "event": "roomGoodsShelfChange",
  "push_msg_url": "https://example.com/push/roomGoodsShelfChange",
  "uid": 123456,
  "data": {
    "uid": 123456,
    "room_id": 10001,
    "custom_menu_id": 20001,
    "goods_ids": "1001,1002",
    "action": "delete",
    "add_time": 1741430500
  }
}