TikTok Shop 集成方案

店铺授权管理

通过 TikTok Shop OAuth 2.0 授权流程，卖家可安全授权平台访问其店铺数据。

• OAuth 授权：通过 auth.tiktok-shops.com/oauth/authorize 发起授权，卖家在 TikTok 页面确认后回调获取授权码
• 令牌交换：调用 /api/v2/token/get 使用授权码换取 access_token 与 refresh_token
• 自动刷新：access_token 过期前自动使用 refresh_token 刷新，无需人工干预
• 店铺识别：通过 /authorization/202309/shops 获取已授权店铺的 shop_cipher，安全标识店铺身份
• 多店铺管理：同一应用可授权管理多个 TikTok Shop 店铺
• 令牌安全：access_token / refresh_token 采用 AES 字段级加密存储

订单同步与管理

• 订单拉取：POST /order/202309/orders/search 按时间范围拉取订单列表
• 状态映射：TikTok Shop 订单状态（UNPAID / AWAITING_SHIPMENT / IN_TRANSIT / DELIVERED / COMPLETED / CANCELLED）映射为内部统一状态
• 双层存储：原始报文存 Raw 层（可溯源），标准化数据存业务层
• 分页同步：支持 page_token 分页拉取，大批量订单分批事务写入

达人营销（Affiliate Seller）

达人搜索与筛选

• 接口：POST /affiliate_seller/202608/marketplace_creators/search
• 筛选维度：粉丝数、粉丝画像（年龄/性别）、GMV 区间、类目、内容表现、佣金率、是否快速增长
• 数据口径：近 30 天达人表现数据；搜索结果缓存支持翻页复用

批量消息邀约

• 建会话：POST /affiliate_seller/202508/conversations
• 发消息：POST /affiliate_seller/202412/conversations/{id}/messages（图文/商品卡片）
• 配额：GET /affiliate_seller/202607/creator_outreach/quota（周配额管理）
• 任务引擎：配额校验 → 逐条执行 → 错误码闭环（配额尽暂停/单达人上限跳过）→ 状态回写，支持暂停/取消/重试

样品管理

• 生成 Deeplink：GET /affiliate_seller/202512/sample_applications/deeplink（引导达人一键申请）
• 申请同步：POST /affiliate_seller/202508/sample_applications/search
• 审批操作：POST /affiliate_seller/202507/sample_applications/{id}/review（批准/拒绝）
• 16 种状态全生命周期管理

联盟订单与效果追踪

• 联盟订单：POST /affiliate_seller/202410/orders/search（单次≤3个月，滚动窗口拉取）
• 达人表现：GET /affiliate_seller/202608/marketplace_creators/{id}（GMV/视频数/直播数）
• 合作达人由联盟订单回流数据推断

数据安全与合规

我们严格遵循 TikTok Shop 数据安全规范，保护卖家数据隐私。

安全措施	说明
传输加密	所有 API 通信使用 HTTPS 加密传输
令牌加密存储	access_token、refresh_token 采用 AES 字段级加密存储
签名认证	每次请求使用 HMAC-SHA256 签名，app_secret 作为签名密钥
权限控制	RBAC 细粒度权限控制，操作审计日志完整记录
数据隔离	多租户数据隔离，租户间不可交叉访问
授权管理	卖家可随时取消授权，取消后 30 天内删除相关数据

详细隐私政策请参阅隐私政策页面。