Tiktok在线商品文档

# Tiktok在线商品业务文档

tiktok官方文档地址：https://bytedance.feishu.cn/docs/doccnDyz5Bbk26iOdejbBRBlLrb#lf3UTU

## 一、业务线

Tiktok的在线商品信息和其他常规平台类似，主要包含了查询类和修改类这两大类，查询类的包含店铺商品拉取、单个商品拉取的接口。修改类的包含价格修改、库存修改等接口。其中查询类的接口为异步调用接口，修改类的为直调接口。需要注意的是在调用Tiktok平台接口时都需要传入Sign，而Sign根据appkey、appSecreat、accessToken字段利用gen算法生成的。

1. 店铺商品拉取
   店铺商品拉取的主要目的是将用户店铺后台的所有商品或者将最新的商品信息同步到我们的系统中进行管理，并向用户提供直接可观的商品信息供用户操作。
   拉取店铺商品的总流程： 需要拉取商品的店铺 —>根据当前的店铺信息调用平台的查询列表接口获取店铺的所有商品信息—>调用同步单个商品接口—>将拉取店铺的状态信息推送给ERP系统进行展示。
   店铺商品拉取时调用平台的 /api/products/search接口。该接口可以传入分页信息和时间参数，因此在第一次全量拉取完成后，后续再调用该接口时，可以传入上次全量拉取时间，进行增量拉取。
2. 单个商品拉取
   单个商品主要目的是为了用户能够在我们系统中查看到自己店铺更加详细的商品信息，并对某个商品进行维护。
   拉取单个商品的总流程：需要拉取的商品Id—>根据当前店铺信息调用平台的获取商品详情接口—>将数据存入数据库并推送给ERP系统进行展示
   单个商品拉取是调用平台的/api/products/details接口，该接口需要传入平台的公共参数和商品id即可。
3. 库存编辑、价格编辑
   库存编辑和价格编辑接口与其他平台一样都是系统直调接口，oapi-product项目直接通过fegin进行调用后台服务，再由后台请求第三方平台。具体调用方法参照平台接口文档
   库存编辑：/api/products/stocks
   价格编辑：/api/products/prices
   需要注意的是库存数不能超过99999.

## 二、代码线
涉及项目：

mdc-open-api-product-service（在线商品对外接口总控程序）（香港）

mps-newegg-product（新蛋核心项目）（香港）

mabang-push-message（推送中间程序）（香港）

mabang-receive-message（推送中间程序）（广州）

1. 具体流程（调用平台接口需要遵循接口QPS规则，如触发QPS需要进入兜底策略重新丢入队列等待下次执行）
- 同步店铺商品
  首先向 mdc-open-api-product 项目中的/product/tiktok/syncShopProduct 接口发送同步店铺消息，接收到请求后，根据店铺信息开始查询中间状态表，若中间表信息不为空并且状态为2则直接返回拉取中的信息。若状态表信息为空，则向中间表插入一条数据并设置状态为拉取中，并向指定队列中丢入一条消息。
  mdc-product-tiktok项目的消费者在监听到队列中在消息后，首先根据站点信息效验站点正确性并根据站点获取对应的店铺信息参数并加入分页参数调取平台接口，获取到平台返回的商品列表信息后，拿到每条商品信息的商品id放入到同步单个商品的队列中，最后向php端推送同步店铺商品状态和最后一条商品信息。并修改中间表拉取状态为同步完成
- 同步单个商品
  同步单个商品有两个入口，第一个入口是通过mdc-open-api-product 项目的/product/tiktok/syncProductMq接口传入商品id向同步单个商品对列中丢入消息
  mdc-product-tiktok项目的消费者在监听到队列中在消息后，开始检查平台的站点是否合法，并根据站点获取对应的请求平台的店铺信息，拿到店铺信息后请求第三方平台接口，接口返回该商品的详细信息。然后与mongo中的的数据进行比对，若不存在则插入该条商品信息，存在则更新此商品数据，最后向php端推送详细的商品信息。
  第二个入口则为同步店铺商品消费者在消费时循环遍历放入到拉取商品信息的队列。后面的消费逻辑同第一个入口的一样。
- 库存、价格编辑
  入口是mdc-open-api-product 项目中的/product/tiktok/updateStock、/product/tiktok/updatePrice接口，通过fegin的方式请求mdc-product-tiktok项目的接口。
  在收到请求后，包装请求参数，直接调用第三方平台修改库存和价格。

2. 商品删除队列
   主要针对同步店铺商品，消费者每次再监听到消息后，先查询本地数据库，再调取平台接口获取商品列表数据，两个列表进行比对，若数据库中存在该商品，接口返回的列表中不存在该商品，则该商品被定义为平台后台移除的商品，此时需要用单独的用一个商品删除的队列推送给php端进行处理。
3. 推送流程
   同步在线商品信息后后需要推送商品数据，首先将信息推送到 mabang-push-message 中，mabang-push-message中消费者拿到数据后再调 mabang-receive-message 接口将数据丢过去，
   最后再由 mabang-receive-message 推给PHP的rabbitMQ队列。

## 三、流程图

1. 同步店铺商品
   ![null](http://175.178.169.18:10086/media/202208/2022-08-31_202733_978550.png)
   ![null](http://175.178.169.18:10086/media/202208/2022-08-31_202756_704962.png)
2. 同步单个商品
   ![null](http://175.178.169.18:10086/media/202208/2022-08-31_203233_821621.png)
   ![null](http://175.178.169.18:10086/media/202208/2022-08-31_203303_807661.png)
   流程图地址：https://www.processon.com/view/link/62a165457d9c08075a3bda59