商品同步集成食谱

本平台不存储你的商品数据——商品的所有权在你的系统。/v1/products/query 是 TikTok Shop 的实时代理（带 60s 短缓存），你按下面的食谱把数据同步进自己的库。

同步食谱（按账号全量刷新）

对某个 TikTok Shop 账号：
1. 拉第 1 页（无 pageToken）→ 清空你库里该账号的商品副本 → 插入
2. 后续页：拿着 nextPageToken 直接插入（不清库）
3. nextPageToken 为空 = 同步完成

示例中 $BASE 为生产环境地址（https://cli.haina.io），$TOKEN 为你的 API Token。

# 第 1 页（shop 为例）
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"accountId":"<creatorUserOpenId>","productType":"shop","pageSize":20}' \
  $BASE/v1/products/query

# 第 2 页：把上页返回的 nextPageToken 带上
curl -X POST ... -d '{"accountId":"...","productType":"shop","pageSize":20,"pageToken":"<nextPageToken>"}' ...

注意事项（坑点）

• 翻页必须在单 productType 下进行：省略 productType 时返回店铺+橱窗两组，两组的游标互相独立（同一个 pageToken 不能跨组用）。同步请分类型各跑一遍。
• pageSize 上限 20（官方限制）。
• 缓存：默认 60s 短缓存（同参数）。调试用 "fresh": true 穿透。
• 可挂车判定（决定能否用于发布）：reviewStatus=APPROVED、inventoryStatus=IN_STOCK、（橱窗类）addedStatus=ADDED、isHidden=false。
• 图片字段 images：已是纯 URL 数组（平台已把官方的原始格式清洗好），按尺寸降序，取 [0] 即最大图。
• 商品价格/库存/审核状态随时在变——你自己的库定期全量刷新，发布前以实时数据为准。

字段口径