快工助手跨境电商知识与商机助手

(17) Shoppable content posting

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 (17) Shoppable content posting

#

§2 Trigger scenario

Trigger scenario

The shoppable content posting webhook is triggered when the creator adds, updates, or removes a product link in a video or livestream.

This webhook will only be triggered after the creator has authorized the Read Creator Affiliate Collaborations scope.

#

§3 Data business parameters

Data business parameters

Parameter nameData TypeSampleDescription
typeint17The ID of the webhook type.
tts_notification_idstring"7327112393057371910"The ID of the notification.
creator_open_idstring"VIyStQAAAADCBQ40s4TzOSSOEIW-bM5O9cod3vK8OytW8m-bnBYlXw"The open_id of the creator. To get the value, see Authorization overview.
timestampint1644412885The UNIX timestamp when this webhook was triggered.
dataobject
└product_idstring"789078671231"ID of the product promoted in the creator's video.
└eventobject
└└typestring"ADD"The action which the creator takes to the product promoted in the video or live stream. The possible enumerations are: * ADD: Add the product. * UPDATE: Update the product. * REMOVE: Remove the product.
└└scenestring"VIDEO"The scene where the creator promotes the product. The possible enumerations are: * VIDEO: short video.
└└content_idstring"789078671231"The ID of the short video.
#

§4 Event example

Event example

{
  "type": 17,
  "creator_open_id": "VIyStQAAAADCBQ40s4TzOSSOEIW-bM5O9cod3vK8OytW8m-bnBYlXw",
  "tts_notification_id" : "7327112393057371910",
  "timestamp": 1644412885,
  "data": {
    "product_id": "789078671231",
    "event": {
      "type": "ADD",
      "scene": "VIDEO",
      "content_id": "789078671231"
    }
  }
}
#