接口说明
将商品的价格变动、销售状态、库存状态、供货状态等信息,通过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
}