电商服务
1 产品简介
百川提供消息服务当商品信息发生变更时，通过消息通道通知给订阅此消息的开发者。
例如商品价格变更，接收到的消息:
{
"timestamp": "2016-05-27 14:53:09",
"item_id": "123456", //商品id
"item_info": {
"location": "杭州", //所在地
"sku_infos": [
{
"price": "1.99", //商品价格
"quantity": "1", //数量
"sku_id": "23412341",
"promotion_price": "1.65" //最低价
}
],
"shop_name": "yoyo的衣服店", //店铺名称
"promotion_price": "1.33",
"post_for_free": "true",
"title": "毛绒袜子",
"price": "3.44",
"cart_support": "true",
"promotion_tips": "淘金币满20抵4元",
"quantity": "234",
"seller_type": "taobao",
"in_sale": "true",
"seller_nick": "yoyo衣服好", //卖家昵称
"img_urls": [
"http://img.jpg,http://isdfasd.jpg" //商品主图地址
]
}
}
2 使用说明
2.1 前置条件
1、先要在开放平台应用管理后台如下页面订阅消息类型，这部分内容可以参考2.2节 商品相关的消息
2、通过2.3节 商品订阅关系API 来添加需要关注的商品
2.2 商品相关的消息
| 消息类型 | 说明 | 触发条件 | 返回内容 |
|---|---|---|---|
| taobao_tae_ItemPriceChange | 商品最低价格变化 | 商品最低价格变化 | 商品实体消息 |
| taobao_tae_ItemTitleChange | 商品title变化 | 商品title变化 | 商品实体消息 |
| taobao_tae_ItemImageChange | 商品主图变化 | 商品主图发生变化 | 商品实体消息 |
| taobao_tae_ItemSoldOut | 商品售空消息 | 商品被售空 | itemId + itemTitle |
| taobao_tae_ItemDelete | 商品删除消息 | 商品被删除 | itemId + itemTitle |
| taobao_tae_ItemDownShelf | 商品下架消息 | 商品下架 | itemId + itemTitle |
| taobao_tae_ItemUpShelf | 商品上架消息 | 商品上架 | 商品实体消息 |
| taobao_tae_ItemSkuSoldOut | SKU售空消息 | SKU被售空 | itemId + itemTitle + skuId + skuDesc |
| taobao_tae_ItemSkuPublish | SKU发布消息 | SKU发布 | 商品实体消息 |
| taobao_tae_ItemSkuDelete | SKU删除消息 | SKU被删除 | itemId + itemTitle + skuId + skuDesc |
| taobao_tae_ItemSubscribe | 添加商品订阅消息 | 订阅商品 | 商品实体消息 |
| taobao_tae_ItemUnSubscribe | 删除商品订阅消息 | 删除商品订阅 | itemId + itemTitle |
消息处理条件：如果商品处于有效状态（非下架状态），或者前一次的处理时间戳早于此消息的时间，则处理
SKU变更消息附加逻辑：sku删除之后有可能导致最低价格变化，走价格变化流程
消息返回具体内容参考第3节
在开放平台应用管理后台如下页面订阅消息：可以在分类中选择“导购平台”快速筛选消息
点击消息名称，就能查看具体的返回信息字段。
2.3 商品订阅关系API
可以通过商品订阅关系API来添加需要关注的商品
| API名称 | 说明 | 文档地址 |
|---|---|---|
| taobao.baichuan.item.subscribe.relation.query | 查询单条订阅关系 | 点击查看 |
| taobao.baichuan.item.subscribe.relations.query | 根据条件批量查询订阅关系 | 点击查看 |
| taobao.baichuan.item.subscribe.daily.left.query | 查询isv当天可添加的余量 | 点击查看 |
| taobao.baichuan.item.unsubscribe | 删除单条订阅关系 | 点击查看 |
| taobao.baichuan.items.unsubscribe | 批量根据商品id删除订阅关系 | 点击查看 |
| taobao.baichuan.items.unsubscribe.by.condition | 按条件批量删除订阅关系 | 点击查看 |
| taobao.baichuan.item.subscribe | 插入一条商品订阅关系 | 点击查看 |
| taobao.baichuan.items.subscribe | 批量插入商品订阅关系 | 点击查看 |
3 返回内容
3.1 商品实体消息
{
"timestamp": "2016-05-27 14:53:09",
"item_id": "123456",
"item_info": {
"location": "杭州",
"sku_infos": [
{
"price": "1.99",
"quantity": "1",
"sku_id": "23412341",
"promotion_price": "1.65"
}
],
"shop_name": "yoyo的衣服店",
"promotion_price": "1.33",
"post_for_free": "true",
"title": "毛绒袜子",
"price": "3.44",
"cart_support": "true",
"promotion_tips": "淘金币满20抵4元",
"quantity": "234",
"seller_type": "taobao",
"in_sale": "true",
"seller_nick": "yoyo衣服好",
"img_urls": [
"http://img.jpg,http://isdfasd.jpg"
]
}
}
3.2 itemId + itemTitle
{
"timestamp": "2016-05-31 19:46:02",
"item_id": "123456",
"item_title": "养猫专用猫砂"
}
3.3 itemId + itemTitle + skuId + skuDesc
{
"timestamp": "2016-05-31 18:18:59",
"item_id": "23412312",
"item_title": "大毛衣手织",
"sku_id": "1234562341",
"sku_desc": "红色大红色"
}