接口说明

将商品的价格变动、销售状态、库存状态、供货状态等信息,通过POST的方式实时同步到客户服务器。收到通知后,请在10秒内返回:“ok"。同一类型的通知可能会推送多次,请技术人员自行做好幂等控制。

接口地址

由客户提供,提供方法:登陆采购平台,进入[账户设置] / [通知订阅] / [商品信息订阅],填写能够正常接收通知的接口地址并保存即可。

通知参数

参数名 类型 必须 说明
event_type string true 事件触发类型,详见下方说明
event_data json true 事件类型对应的数据,详见下方说明
product_id int true 商品编号
product_name string true 商品名称
product_type int true 商品类型(1:充值,2:卡密,3:卡券)

event_type说明

event_type 描述
product_configured 新增配置商品
product_deleted 删除已配置商品(此时event_data为空)
stock_changed 库存状态改变
supply_changed 商品状态改变
hold_changed 供货状态改变
price_changed 商品售价改变
time_limit_enabled 开启禁售时段
time_limit_disabled 关闭禁售时段
time_limit_changed 禁售时段改变

event_data说明

参数名 类型 描述
stock_state int 库存状态(1:断货,2:充足)
supply_state int 状态(1:上架,2:维护,3:下架)
hold_state int 供货状态 (1.允许采购,2.限制采购)
price double 当前售价
ban_start_at string 禁售开始时间,为空表示不限制
ban_end_at string 禁售结束时间,为空表示不限制
示例
{
  "customer_id": 6,
  "event_data": "{\"stock_state\":2,\"supply_state\":1,\"hold_state\":1,\"price\":\"168.000\",\"ban_start_at\":\"\",\"ban_end_at\":\"\"}",
  "event_type": "price_changed",
  "product_id": 2,
  "product_name": "爱奇艺黄金会员年卡",
  "product_type": 1,
  "sign": "8581a8c64421c6c51f7073d893b98053",
  "timestamp": 1689674793
}